create-skilllisted
Install: claude install-skill mthines/agent-skills
# 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