people-report

Generate headcount, attrition, diversity, and org health reports from employee CSV data.

1|1|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/williamthorsen/codeassembly --skill people-report-williamthorsen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: people-report
Source: https://github.com/williamthorsen/codeassembly/tree/main/packages/agents/content/skills/people-report
Command: npx skills add https://github.com/williamthorsen/codeassembly --skill people-report-williamthorsen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning raw employee spreadsheets into meaningful HR analytics requires manual column mapping, metric calculation, and report writing. This Skill automates that workflow, producing structured headcount, attrition, diversity, and org health reports directly from user-provided employee data. ## Core Features & Use Cases - Four report types: Generate headcount snapshots, attrition and turnover analysis, diversity and representation metrics, or org health assessments covering span of control and flight risk. - Adaptive column inference: Maps varied column headers (e.g., Dept, Team, Business Unit) to recognized fields, confirming ambiguous mappings with the user before proceeding. - Field coverage assessment: Evaluates which analyses are possible given available fields and transparently notes limitations such as small sample sizes or missing data. - Use Case: An HR partner pastes a CSV export of 500 employees and requests an attrition report; the Skill maps the columns, computes voluntary versus involuntary turnover by department, and delivers a formatted report with recommendations and methodology notes. ## Quick Start Use the people-report skill to generate an attrition report from the employee data in my attached CSV file.

Frequently Asked Questions about people-report

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate an attrition report from employee data?

Provide employee data as pasted CSV or a file path and request the attrition report type. The Skill computes overall attrition rate, voluntary versus involuntary breakdown, and trends by department, requiring start dates and termination dates or reasons.

What data do I need for a headcount analysis report?

Headcount analysis requires at minimum an employee identifier and a department or team column. Additional fields like location, level, or hire date enable breakdowns by location, level, and tenure.

Can I generate multiple HR report types at once?

Yes, pass a comma-separated list via the --report-type argument, such as headcount,attrition,diversity. When multiple types are requested, the output uses a top-level report header with each type as its own section.

What happens if my employee data is missing columns?

The Skill assesses field coverage per report type and proceeds with available analyses while noting what is missing. It only stops if both minimum fields, an employee identifier and a department column, are absent.

Does this tool connect to HRIS systems like Workday or BambooHR?

No, all analysis runs on user-provided data only. There are no HRIS or messaging integrations; you supply employee data as pasted CSV, TSV, or a file path.