crew-pm

Manages crew state, role onboarding, and dispatch decisions from crew_state.py output.

2|Updated Jul 28, 2026
One-click install
npx skills add https://github.com/mbadali25/useful-claude-add-ons --skill crew-pm-mbadali25
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: crew-pm
Source: https://github.com/mbadali25/useful-claude-add-ons/tree/main/plugin/crew/skills/crew-pm
Command: npx skills add https://github.com/mbadali25/useful-claude-add-ons --skill crew-pm-mbadali25

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Multi-agent crews lose track of their own state: which roles are active, whether the codemap and diagrams are stale, which tickets are open, and whether review gates are running. This Skill gives the persistent project-manager agent a single procedure for reading crew state, acting on it within a configured authority level, and keeping the crew's composition and knowledge artifacts current. ## Core Features & Use Cases - Crew state interpretation: Reads the JSON output of crew_state.py (health rate, open tickets, codemap freshness, diagram staleness, incident status, triggers) and reports prioritized findings without re-deriving metrics by hand. - Tiered authority model: Operates under report-only, act, or autonomous modes from .crew/config.json, with hard stops requiring explicit user approval for role offboarding, map deletion, metrics rewrites, and destructive git operations. - Role lifecycle management: Onboards repos and roles with evidence-based justification from .crew/metrics.md, and offboards roles while recording the specific coverage gap left behind. - Use Case: A user asks "how is the crew doing?" — the PM runs crew_state.py, reports that two diagrams are behind HEAD and a handoff note is pending, then under act authority dispatches an explorer and docs-writer to refresh them. ## Quick Start Ask the crew PM to report current crew status and recommend what needs attention.

Frequently Asked Questions about crew-pm

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

FAQPage Schema
How do I check the status of a Claude Code agent crew?

Run crew_state.py from the plugin's hooks/scripts directory and interpret its JSON output. It reports crew composition, review health rate, open tickets, codemap and diagram freshness, and any active incidents, with triggers pre-prioritized for reporting.

How do I onboard a new role to an agent crew?

Name the specific defect class the role closes, verify .crew/metrics.md shows that pattern recurring, get user approval, then add the role to config.json roles and recompute the tier. Domain specialists are justified by the repo's stack instead of metrics.

What is the difference between report-only, act, and autonomous authority modes?

Report-only only recommends; act dispatches roles and does work but still asks open questions; autonomous settles its own decisions using the recommended option. All modes require explicit approval for role removal, map deletion, metrics rewrites, and destructive git operations.

When should a role be offboarded from the crew?

Offboard when metrics show the role's defect class no longer occurs, but always record the removal in .crew/metrics.md with the specific coverage gap it creates. A removal without a named failure mode is a silent coverage regression.

Why does the codemap report stale when the code has not changed?

The knowledge.behind flag only compares the map's anchor commit against HEAD, so repo-wide changes like version bumps mark every map behind. Run git diff between the anchor and HEAD for the documented paths to confirm whether content actually changed.