skill-lifecycle-manager

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.internal or 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.