diff --git a/claude-skills/skill-creator.md b/claude-skills/skill-creator.md new file mode 100644 index 0000000..a0dd3ee --- /dev/null +++ b/claude-skills/skill-creator.md @@ -0,0 +1,59 @@ +--- +name: skill-creator +description: Create a new reusable Claude Code skill from scratch. Use when the user wants to encode a repeatable workflow, process, or domain expertise into a skill file. +--- + +# Skill Creator + +Use when: building a new skill to encode a workflow, process, checklist, or domain expertise that should be reusable across sessions. + +## What Makes a Good Skill +- **Specific trigger** — clear "use when" condition so Claude knows when to invoke it +- **Process, not just content** — steps to follow, not just reference info +- **Opinionated** — makes decisions so the user doesn't have to repeat themselves +- **Testable** — you can tell if it's being followed correctly + +## Skill File Format + +```markdown +--- +name: skill-name # kebab-case, matches filename +description: One line explaining when and why to use this skill. +--- + +# Skill Title + +Use when: [specific trigger condition] + +## [Section 1] +[Content] + +## [Section 2] +[Content] + +## Rules / Constraints +- Hard rules the skill enforces +``` + +## Process for Creating a New Skill + +1. **Understand the workflow** — ask the user: + - What task does this skill help with? + - When should it be triggered (what user phrase or situation)? + - What are the non-obvious things to remember? + - What mistakes does it prevent? + +2. **Draft the skill** — write a SKILL.md with: + - Clear frontmatter (name, description) + - Trigger condition upfront + - Step-by-step process OR checklist + - Rules/constraints section + - Example output if helpful + +3. **Save to `~/.claude/skills/.md`** + +4. **Test it** — invoke the skill and confirm it produces the right behavior + +## Skill Location +Skills go in `~/.claude/skills/` as individual `.md` files. +They're invoked with `/skill-name` or detected automatically from the description.