Skill Lifecycle Manager
Classify repository skills by lifecycle stage and readiness gates.
Scope: Read-only lifecycle reporting. Does not edit skills, run installs, or mutate catalog indexes.
Dispatch
| $ARGUMENTS | Action |
|---|---|
<name> |
Lifecycle report for one skill |
repo / --all |
Summary for every skills/*/ directory |
--format json |
Machine-readable report |
| Empty | Show stage definitions and example commands |
Lifecycle Stages
| Stage | Signals |
|---|---|
draft |
TODO description, missing evals, or failing scripts/check.py contract |
internal |
metadata.internal: true |
active |
Valid frontmatter, eval manifest, and portable validator present |
deprecated |
Body or metadata marks deprecation (maintainer-authored) |
Workflow
uv run python skills/skill-lifecycle-manager/scripts/lifecycle_report.py <name>
uv run python skills/skill-lifecycle-manager/scripts/lifecycle_report.py --all --format json
Pair lifecycle output with /skill-creator audit before promotion.
Validation Contract
uv run python skills/skill-lifecycle-manager/scripts/check.py
Critical Rules
- Never auto-promote a skill based on lifecycle heuristics alone.
- Treat missing evals as a draft signal, not a hard block for internal skills.
- Do not mutate
metadata.internalor catalog authoring rows from this skill. - Run the repo validation command before declaring a skill active-ready.
- Route executable fixes to skill-creator or the maintainer lead.