people-report

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.

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