/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
- 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-report
3description: 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.
4argument-hint: "<report type — headcount, attrition, diversity, org health>"
5---
6
7# /people-report
8
9> If you see unfamiliar placeholders or need to check which tools are connected, see [CONNECTORS.md](../../CONNECTORS.md).
10
11Generate people analytics reports from your HR data. Analyze workforce data to surface trends, risks, and opportunities.
12
13## Usage
14
15```
16/people-report $ARGUMENTS
17```
18
19## Report Types
20
21**Headcount**: Current org snapshot — by team, location, level, tenure
22**Attrition**: Turnover analysis — voluntary/involuntary, by team, trends
23**Diversity**: Representation metrics — by level, team, pipeline
24**Org Health**: Span of control, management layers, team sizes, flight risk
25
26## Key Metrics
27
28### Retention
29- Overall attrition rate (voluntary + involuntary)
30- Regrettable attrition rate
31- Average tenure
32- Flight risk indicators
33
34### Diversity
35- Representation by level, team, and function
36- Pipeline diversity (hiring funnel by demographic)
37- Promotion rates by group
38- Pay equity analysis
39
40### Engagement
41- Survey scores and trends
42- eNPS (Employee Net Promoter Score)
43- Participation rates
44- Open-ended feedback themes
45
46### Productivity
47- Revenue per employee
48- Span of control efficiency
49- Time to productivity for new hires
50
51## Approach
52
531. Understand what question they're trying to answer
542. Identify the right data (upload, paste, or pull from ~~HRIS)
553. Analyze with appropriate statistical methods
564. Present findings with context and caveats
575. Recommend specific actions based on data
58
59## What I Need From You
60
61Upload a CSV or describe your data. Helpful fields:
62- Employee name/ID, department, team
63- Title, level, location
64- Start date, end date (if applicable)
65- Manager, compensation (if relevant)
66- Demographics (for diversity reports, if available)
67
68## Output
69
70```markdown
71## People Report: [Type] — [Date]
72
73### Executive Summary
74[2-3 key takeaways]
75
76### Key Metrics
77| Metric | Value | Trend |
78|--------|-------|-------|
79| [Metric] | [Value] | [up/down/flat] |
80
81### Detailed Analysis
82[Charts, tables, and narrative for the specific report type]
83
84### Recommendations
85- [Data-driven recommendation]
86- [Action item]
87
88### Methodology
89[How the numbers were calculated, any caveats]
90```
91
92## If Connectors Available
93
94If **~~HRIS** is connected:
95- Pull live employee data — headcount, tenure, department, level
96- Generate reports without needing a CSV upload
97
98If **~~chat** is connected:
99- Offer to share the report summary in a relevant channel