Skip to content

Convert Claude plugin to Rovo skills #364

Description

@williamthorsen

Problem

The people-report plugin from the Claude Plugin Hub provides useful HR analytics capabilities (headcount, attrition, diversity, org health reports), but it's only available on that platform. We want this skill available to both Claude Code and Rovo Dev users via the agents package.

Context

  • Source plugin: anthropics-human-resources-human-resources/people-report on claudepluginhub.com (https://www.claudepluginhub.com/skills/anthropics-human-resources-human-resources/people-report)
  • The source plugin relies on platform-specific HRIS and chat connectors that don't apply here — the skill will accept user-provided data instead
  • This is a shared skill (not platform-specific), installed to both Claude and Rovo Dev
  • HRIS MCP integration is a potential future enhancement, out of scope for this ticket

Solution

Create a shared skill at packages/agents/content/skills/people-report/SKILL.md that:

  • Report types: Supports headcount, attrition, diversity, and org health reports
  • Invocation: /people-report prompts interactively for report type; --report-type=headcount,attrition skips the prompt
  • Data input: Accepts CSV paste or file upload in any format; infers column meanings from headers and asks for clarification on ambiguous columns
  • Adaptive analysis: Works with whatever fields are available; minimum requirement is employee identifier + department/team; notes which analyses were skipped due to missing fields and what columns would unlock them
  • Output: Structured markdown report (executive summary, key metrics table, detailed analysis, recommendations, methodology with caveats)

Acceptance criteria

  • SKILL.md exists at packages/agents/content/skills/people-report/ with correct frontmatter (name, description, user-invocable: true)
  • Skill covers all four report types with appropriate metrics for each
  • --report-type argument skips interactive prompt; absence of the argument triggers interactive selection
  • Skill infers column meanings from user-provided data rather than requiring a fixed schema
  • Skill validates minimum required fields (employee ID/name + department/team) before proceeding
  • Missing fields produce clear guidance on what analyses are unavailable and what columns would enable them
  • Output follows the structured report template (executive summary, metrics, analysis, recommendations, methodology)
  • Skill installs correctly for both platforms (verify with pnpm run ws test in agents package)

Metadata

Metadata

Assignees

No one assigned

    Labels

    featureAdded or improved external functionalityscope:agents

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions