create-skill

# Create Skill Author new agent skills — and audit existing ones — against the best practices distilled from Anthropic's official Skill authoring guide and the patterns already in this repo. Output is a complete skill directory plus the agent-skills.git symlink wiring and inventory updates. > **This `SKILL.md` is a thin index.** Detailed authoring rules live in > `rules/*.md` and load on demand. Worked examples live in > `references/*.md`. Literal scaffolding templates live in > `templates/*.md`. Reading them all up-front would burn tokens you do not > need yet — load only what the current phase asks for. --- ## Mode Detection Parse `$ARGUMENTS` (first token) and detect the mode: | Mode | Default | Trigger | | ---------- | ------- | ------------------------------------------------------------------------ | | `scaffold` | **yes** | Default. "create", "scaffold", "new skill", or no mode argument. | | `review` | | "review", "audit", "check this skill", or `$0 == "review"`. | | `upgrade` | | "upgrade", "split", "convert to multi-file", or `$0 == "upgrade"`. | | `diagnose` | | "diagnose", "why did <skill> miss this", or `$0 == "diagnose"`. | If the user typed a path or skill name as `$ARGUMENTS`, treat it as the target for `review`/`upgrade`/`diagnose`; for `scaffold` it is the proposed skill name. State the detected mode and target in one l...