people-report — Claude Code skill: workforce and org health reports
Skill to generate headcount, attrition, diversity, and org health reports from HR data. Pulls snapshots by team, analyzes turnover trends and flight risk indicators across the organization.
npx skills add anthropics/knowledge-work-plugins --skill people-report -a claude-codeWhat people-report does
people-report produces four report types: current headcount by team and level, turnover analysis broken down by voluntary and involuntary separations, diversity representation across hierarchy and function, and org health assessment via span of control and management layers. The skill works with uploaded CSV files or connected HRIS data — it needs employee ID, department, level, start and end dates, and demographics for diversity reports.
Reports include key metrics (attrition rate, average tenure, flight risk), detailed analysis with tables and charts, data-driven recommendations, and calculation methodology. Output is markdown with executive summary and justified conclusions — ready for leadership review.
What it helps with
- Pull a headcount snapshot by team and level within a day
- Analyze turnover trends and identify attrition risk in departments
- Prepare diversity metrics for investor or compliance reporting
- Assess management efficiency: span of control and organizational layers
Example prompts for the agent
- /people-report headcount
- /people-report attrition
- /people-report diversity
How to install people-report
1Skills CLI (Vercel)
npx skills add anthropics/knowledge-work-plugins --skill people-report -a claude-code2Manually: put the files in place
~/.claude/skills/people-report/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/people-report/
1Skills CLI (Vercel)
npx skills add anthropics/knowledge-work-plugins --skill people-report -a codex2Manually: put the files in place
.agents/skills/people-report/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add anthropics/knowledge-work-plugins --skill people-report -a cursor2Manually: put the files in place
.cursor/skills/people-report/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install anthropics/knowledge-work-plugins people-report2Manually: put the files in place
.github/skills/people-report/SKILL.md1Skills CLI (Vercel)
npx skills add anthropics/knowledge-work-plugins --skill people-report -a gemini-cli2Platform CLI
gemini skills install https://github.com/anthropics/knowledge-work-plugins --path human-resources/skills/people-reportManually: put the files in place
.devin/skills/people-report/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add anthropics/knowledge-work-plugins --skill people-report -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set89
The whole set →Similar
Questions about people-report
How do I install people-report in Claude Code?
Run npx skills add anthropics/knowledge-work-plugins --skill people-report -a claude-code in your terminal, then set the path to ~/.claude/skills/people-report/SKILL.md.
What does people-report do?
It generates four report types: current headcount, turnover analysis, diversity representation, and org health metrics. Analyzes HR data to surface trends and risks, delivering metrics with recommendations.
What data do I need to run a report?
Upload a CSV or describe your data: employee ID, department, team, title, level, location, start and end dates, manager, compensation if relevant, and demographics for diversity reports.
Source text
SKILL.md · Apache-2.0
--- 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 ```markdown ## 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
© anthropics · Apache-2.0 · anthropics/knowledge-work-plugins