/people-report
If you see unfamiliar placeholders or need to check which tools are connected, see CONNECTORS.md ({{ref:connectors}}).
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
- Understand what question they're trying to answer
- Identify the right data (upload, paste, or pull from ~~HRIS)
- Analyze with appropriate statistical methods
- Present findings with context and caveats
- 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
1---2name: people-report3description: 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.4---56# /people-report78> If you see unfamiliar placeholders or need to check which tools are connected, see CONNECTORS.md (`{{ref:connectors}}`).910Generate people analytics reports from your HR data. Analyze workforce data to surface trends, risks, and opportunities.1112## Usage1314```15/people-report $ARGUMENTS16```1718## Report Types1920**Headcount**: Current org snapshot — by team, location, level, tenure21**Attrition**: Turnover analysis — voluntary/involuntary, by team, trends22**Diversity**: Representation metrics — by level, team, pipeline23**Org Health**: Span of control, management layers, team sizes, flight risk2425## Key Metrics2627### Retention28- Overall attrition rate (voluntary + involuntary)29- Regrettable attrition rate30- Average tenure31- Flight risk indicators3233### Diversity34- Representation by level, team, and function35- Pipeline diversity (hiring funnel by demographic)36- Promotion rates by group37- Pay equity analysis3839### Engagement40- Survey scores and trends41- eNPS (Employee Net Promoter Score)42- Participation rates43- Open-ended feedback themes4445### Productivity46- Revenue per employee47- Span of control efficiency48- Time to productivity for new hires4950## Approach51521. Understand what question they're trying to answer532. Identify the right data (upload, paste, or pull from ~~HRIS)543. Analyze with appropriate statistical methods554. Present findings with context and caveats565. Recommend specific actions based on data5758## What I Need From You5960Upload a CSV or describe your data. Helpful fields:61- Employee name/ID, department, team62- Title, level, location63- Start date, end date (if applicable)64- Manager, compensation (if relevant)65- Demographics (for diversity reports, if available)6667## Output6869```markdown70## People Report: [Type] — [Date]7172### Executive Summary73[2-3 key takeaways]7475### Key Metrics76| Metric | Value | Trend |77|--------|-------|-------|78| [Metric] | [Value] | [up/down/flat] |7980### Detailed Analysis81[Charts, tables, and narrative for the specific report type]8283### Recommendations84- [Data-driven recommendation]85- [Action item]8687### Methodology88[How the numbers were calculated, any caveats]89```9091## If Connectors Available9293If **~~HRIS** is connected:94- Pull live employee data — headcount, tenure, department, level95- Generate reports without needing a CSV upload9697If **~~chat** is connected:98- Offer to share the report summary in a relevant channel