People Report
Pull leadership-ready HR snapshots—headcount, attrition, diversity, or org health—from connected people data without building spreadsheets by hand.
Overview
People Report is an agent skill for the Operate phase that generates headcount, attrition, diversity, or org health reports from HR data.
Install
npx skills add https://github.com/anthropics/knowledge-work-plugins --skill people-reportWhat is this skill?
- Four report types: Headcount, Attrition, Diversity, Org Health
- Retention metrics: overall and regrettable attrition, tenure, flight risk indicators
- Diversity pipeline: representation by level/team, promotion rates, pay equity framing
- Engagement and productivity lenses: survey/eNPS themes, revenue per employee, span of control
- 4 report types: Headcount, Attrition, Diversity, Org Health
Adoption & trust: 1.4k installs on skills.sh; 19.6k GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
Leadership wants a credible people snapshot but exporting and reconciling HR metrics manually eats a full day.
Who is it for?
Founders managing 5–50 employees who need repeatable HR reporting without a dedicated people-analytics team.
Skip if: True solopreneurs with no employees, or legal-grade pay-equity filings that require certified statisticians and counsel.
When should I use this skill?
Pulling a headcount snapshot for leadership, analyzing turnover trends by team, preparing diversity representation metrics, or assessing span of control and flight risk.
What do I get? / Deliverables
You get a typed people analytics report with standard retention, diversity, engagement, and org-structure metrics ready for review or slides.
- Headcount, attrition, diversity, or org health report narrative
- Metric summaries across retention and engagement families
Recommended Skills
Journey fit
Workforce planning and org risk surface once you are running a team in production, not during first prototype. Org health, span of control, and flight risk support iterative operational decisions rather than greenfield coding.
How it compares
Agent-guided HR report workflow—not a standalone BI warehouse or payroll MCP by itself.
Common Questions / FAQ
Who is people-report for?
Small-team founders, ops leads, and managers preparing board or leadership updates on workforce health.
When should I use people-report?
During Operate when you need a headcount snapshot, turnover trends by team, diversity metrics, or span-of-control and flight-risk analysis before hiring or reorg decisions.
Is people-report safe to install?
It processes sensitive HR data via plugin connectors; review the Security Audits panel on this page and limit connector scopes to least privilege.
SKILL.md
READMESKILL.md - People Report
# /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