| name | skill-new |
| description | Scaffold a new Clade skill end-to-end — interviews for use cases and trigger phrases, generates SKILL.md + prompt.md with spec-validated frontmatter (bilingual triggers, NOT-for disambiguation), wires golden-set routing tests, and runs the lint gate before committing |
| when_to_use | create a new skill, scaffold a skill, add a skill, write a new slash command, build a skill for X, 新建技能, 创建技能, 写个新技能 — NOT for hook generation (use /generate-hook), NOT for absorbing external skill repos (use /equip) |
| user_invocable | true |
| argument-hint | [skill-name or one-line description of what it should do] |
Skill New
Scaffolds a new skill for the Clade skill registry (configs/skills/),
encoding the Agent Skills spec rules (agentskills.io) and Clade's own
conventions so every new skill is born consistent, discoverable, and tested.
What it does
- Checks the existing 127+ skills for overlap first (extend beats duplicate)
- Interviews for the missing pieces: use cases, trigger phrases (EN + 中文),
sibling disambiguation, invocability, arguments
- Generates
SKILL.md (discovery layer) + prompt.md (execution body)
following the frontmatter hard rules enforced by validate-skills.py
- Adds golden-set routing test cases to
orchestrator/tests/test_routing_eval.py so triggering is CI-guarded
- Runs the full validation gate: skill lint + routing eval
- Commits via
committer and reminds about ./install.sh deploy
Usage
/skill-new # full interview
/skill-new pdf-extract # name known, interview the rest
/skill-new "summarize meeting notes into action items"
Frontmatter hard rules (validated, don't fight them)
name = directory name, kebab-case, no "claude"/"anthropic"description ≤ 1024 chars, single line, WHAT + key capabilities, no < >when_to_use carries trigger phrases users would actually type (EN + 中文),
ending with NOT for X (use /y) clauses when siblings could confuse routingSKILL.md body under 500 lines (Agent Skills spec); execution detail lives
in prompt.md, bulky reference material in references/- No
README.md inside the skill folder
