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