people-report
anthropics/knowledge-work-plugins
Generate headcount, attrition, diversity, and org health reports from HR data.
What is people-report?
Analyzes workforce data to surface trends, risks, and opportunities across your organization. Use this skill to pull headcount snapshots for leadership, analyze turnover patterns by team, prepare diversity metrics, or assess organizational structure and flight risk.
- Generate headcount reports with org snapshots by team, location, level, and tenure
- Analyze attrition trends including voluntary/involuntary turnover and regrettable attrition rates
- Calculate diversity representation metrics by level, team, function, and hiring pipeline
- Assess organizational health through span of control, management layers, and flight risk indicators
- Compute retention metrics including overall attrition rate, average tenure, and engagement scores
- Provide productivity analysis including revenue per employee and time to productivity
How to install people-report
npx skills add https://github.com/anthropics/knowledge-work-plugins --skill people-report- HR data in CSV format or connected HRIS system
- Employee data fields: name/ID, department, team, title, level, location, start/end dates, manager, demographics (optional)
How to use people-report
- 1.Specify the report type: headcount, attrition, diversity, or org health
- 2.Upload a CSV file with your employee data or connect your HRIS system
- 3.Provide any specific filters or dimensions you want analyzed (e.g., by team, location, level)
- 4.Review the generated report with executive summary, key metrics, detailed analysis, and recommendations
- 5.Use the methodology section to understand calculations and any data caveats
Use cases
- Pull a current headcount snapshot to present workforce composition to leadership
- Analyze turnover trends by team to identify retention risks and regrettable attrition patterns
- Prepare diversity representation metrics and pipeline analysis for compliance or strategic planning
- Assess span of control and management layer efficiency across the organization
- Identify flight risk employees and recommend targeted retention actions
- HR leaders and people operations teams
- Executive leadership reviewing workforce metrics
- Diversity and inclusion program managers
- Organizational development professionals
- Finance teams analyzing headcount and productivity metrics
people-report FAQ
At minimum: employee name/ID, department, team, title, level, and location. For attrition reports add start/end dates. For diversity reports include demographic data. For engagement analysis include survey scores or eNPS data.
Yes, if your HRIS system is connected as a connector, the skill can pull live employee data automatically and generate reports without requiring CSV uploads.
Org health reports cover span of control, management layers, team sizes, flight risk indicators, and organizational structure efficiency metrics.
The methodology section of each report explains how metrics are calculated. Regrettable attrition typically focuses on voluntary departures of high-performing or critical employees.
If a chat connector is available, the skill can share report summaries to relevant channels. Otherwise, export the markdown report directly.
Full instructions (SKILL.md)
Source of truth, from anthropics/knowledge-work-plugins.
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
- 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
Related skills
More from anthropics/knowledge-work-plugins and the wider catalog.
performance-report
Generate marketing performance reports with metrics, trends, wins, and prioritized optimization recommendations.
performance-review
Structure performance reviews with self-assessment templates, manager feedback, and calibration prep.
pipeline-review
Analyze pipeline health, prioritize deals, and flag risks with a weekly action plan.
plan-payroll
Forecasts cash, ranks overdue invoices, and stages PayPal reminders so the owner can confidently run payroll. Accepts optional horizon and payroll-date arguments.
plan-zoom-integration
Turn a Zoom integration idea into an implementation plan with architecture, auth, and delivery milestones. Use when you need a practical build plan, phased delivery sequence, risk list, and next-step recommendation.
plan-zoom-product
Choose the right Zoom building surface for a use case and explain the tradeoffs clearly. Use when deciding between REST API, Webhooks, WebSockets, Meeting SDK, Video SDK, Zoom Apps SDK, Phone, Contact Center, or MCP for a specific product idea or integration goal.