Markdown

--- name: people-report description: Generate headcount, attrition, diversity, or org health reports. Use when pulling a headcount snapshot for leadership, analyzing turnover trends by team, preparing diversity representation metrics, or assessing span of control and flight risk across the org. argument-hint: "<report type — headcount, attrition, diversity, org health>" ---

/people-report

If you see unfamiliar placeholders or need to check which tools are connected, see [CONNECTORS.md](../../CONNECTORS.md).

Generate people analytics reports from your HR data. Analyze workforce data to surface trends, risks, and opportunities.

Usage

/people-report $ARGUMENTS

Report Types

**Headcount**: Current org snapshot — by team, location, level, tenure **Attrition**: Turnover analysis — voluntary/involuntary, by team, trends **Diversity**: Representation metrics — by level, team, pipeline **Org Health**: Span of control, management layers, team sizes, flight risk

Key Metrics

Retention

  • Overall attrition rate (voluntary + involuntary)
  • Regrettable attrition rate
  • Average tenure
  • Flight risk indicators

Diversity

  • Representation by level, team, and function
  • Pipeline diversity (hiring funnel by demographic)
  • Promotion rates by group
  • Pay equity analysis

Engagement

  • Survey scores and trends
  • eNPS (Employee Net Promoter Score)
  • Participation rates
  • Open-ended feedback themes

Productivity

  • Revenue per employee
  • Span of control efficiency
  • Time to productivity for new hires

Approach

  1. Understand what question they're trying to answer
  2. Identify the right data (upload, paste, or pull from ~~HRIS)
  3. Analyze with appropriate statistical methods
  4. Present findings with context and caveats
  5. Recommend specific actions based on data

What I Need From You

Upload a CSV or describe your data. Helpful fields:

  • Employee name/ID, department, team
  • Title, level, location
  • Start date, end date (if applicable)
  • Manager, compensation (if relevant)
  • Demographics (for diversity reports, if available)

Output

## People Report: [Type] — [Date]

### Executive Summary
[2-3 key takeaways]

### Key Metrics
| Metric | Value | Trend |
|--------|-------|-------|
| [Metric] | [Value] | [up/down/flat] |

### Detailed Analysis
[Charts, tables, and narrative for the specific report type]

### Recommendations
- [Data-driven recommendation]
- [Action item]

### Methodology
[How the numbers were calculated, any caveats]

If Connectors Available

If **~~HRIS** is connected:

  • Pull live employee data — headcount, tenure, department, level
  • Generate reports without needing a CSV upload

If **~~chat** is connected:

  • Offer to share the report summary in a relevant channel