| name | mine.write-skill |
| description | Use when the user says: "create a skill", "write a skill", "new skill", or wants to author a new SKILL.md. Guided skill creation following Claudefiles conventions. |
| user-invocable | true |
Write Skill
Guided creation of a new skill for this repo. Gathers requirements, drafts the skill, validates against a quality checklist, and writes it to the correct location.
Arguments
$ARGUMENTS — optional skill name or description. If provided, use as starting context.
Phase 1: Requirements
Ask these one at a time. Skip any already answered by $ARGUMENTS.
AskUserQuestion:
question: "What task should this skill handle? Describe the problem it solves."
header: "Purpose"
AskUserQuestion:
question: "What trigger phrases should invoke it? (e.g., when the user says 'audit the codebase')"
header: "Triggers"
AskUserQuestion:
question: "What does the output look like? (e.g., a file, a report, a question, an action)"
header: "Output"
AskUserQuestion:
question: "Should this be user-invocable (slash command) or a reference skill (loaded by other skills only)?"
header: "Invocability"
multiSelect: false
options:
- label: "User-invocable"
description: "Can be called directly via /mine.<name>"
- label: "Reference only"
description: "Loaded by other skills, not directly callable"
Then explore the codebase for related skills, patterns, or existing work that should inform the new skill's design.
Phase 2: Draft
Determine the skill name
Derive from the purpose: mine.<kebab-case-name>. Max 30 chars total. Check that skills/mine.<name>/ doesn't already exist.
Write SKILL.md
Write to skills/mine.<name>/SKILL.md using the template in REFERENCE.md. See REFERENCE.md for conventions, AskUserQuestion constraints (header ≤12 chars, max 4 options), and size guidance.
Phase 3: Quality Checklist
Validate the drafted skill against the quality checklist in REFERENCE.md (full criteria there). Quick list:
- Description includes "Use when..." trigger phrases
- SKILL.md under ~100 lines (or split with REFERENCE.md)
- No time-sensitive info (dates, versions)
- Consistent terminology throughout
- At least one concrete example of output
- References at most one level deep
- No significant duplication with existing skills
- All user interaction points use AskUserQuestion
Report results. Fix any failures before presenting to the user.
Phase 4: Wiring
After the user approves the skill:
- Add a routing entry to
rules/common/capabilities.md using the trigger phrases from Phase 1
- Add a row to the Skills table in
README.md (alphabetical order) and update the skill count in the section header
- Remind the user to run
./install.sh to create the symlink