skill-builder

# Skill Builder — Create, heal, and audit skill packages `skill-builder` owns the full structural lifecycle of one `skills/<slug>/` source package: create it, verify its structure, repair owned projections, and audit its content discipline. It does not schedule work, allocate writers, operate Git, validate a software candidate, promote learnings, or decide what happens after a failure. Before creating a new root, search `skills/*/SKILL.md` for an existing owner. Extend an existing skill when it already owns the requested behavior. ## Modes | Trigger phrases | Mode | Entry point | |---|---|---| | "create a skill", "scaffold skill", "new skill" | create (build) | `scripts/build.sh` | | "absorb external skill" | create (absorb-external) | `scripts/build.sh` | | "check skill package" | check | `scripts/heal.sh --check [--strict]` | | "heal skill", "repair skill hygiene" | heal | `scripts/heal.sh --fix` | | "audit skill structure" | audit | `scripts/audit.sh` | ## Constraints - Create exactly one source package because metadata must have one canonical owner. - Treat external skills as structural signals only because clean-room output must not copy names, prose, prompts, scripts, or examples. - Regenerate projections once and stop because validation, revision, Git, and delivery remain caller-owned. - Check and audit modes never mutate files; fix mode changes only an explicit source target and its owned projections, because source behavior remains human-authored. ##...