write-skill

name	write-skill
description	Meta-skill that creates new Claude Code skills. Describe what you want the skill to do and this generates a complete SKILL.md with proper frontmatter, shell injection, structured instructions, and output format.
argument-hint	[description of the skill to create]
allowed-tools	Read, Grep, Glob, Write
disable-model-invocation	true

Skill Creator

Existing Skills (for pattern reference)

!ls .claude/skills/ 2>/dev/null

---

Process

Step 1: Gather Requirements

From the user's description, determine:

1. Name: lowercase-with-hyphens, becomes the /slash-command
2. Purpose: What does this skill do?
3. Trigger: When should someone use it?
4. Input: What arguments does it need?
5. Output: What should it produce?
6. Tools needed: Which Claude Code tools does it require?

Step 2: Generate SKILL.md

Create the file following this template:

---
name: skill-name
description: "One sentence: what it does + when to use it. Be specific enough for auto-invocation."
argument-hint: "[argument description]"
allowed-tools: Read, Grep, Glob
---

# Skill Title

## Context Detection
!`relevant shell command for auto-detecting project context`

---

## Instructions

### Step 1: [First action]
Detailed instructions for what Claude should do.

### Step 2: [Second action]
...

### Step N: [Final action]
...

## Output Format
Describe the expected structure of the output.

## Rules
- Rule 1
- Rule 2

Step 3: Validate the Skill

Check the generated SKILL.md against these requirements:

• Frontmatter has name and description (required)
• Description is under 150 characters and specific
• allowed-tools lists only what's needed (principle of least privilege)
• Shell injection uses !command`` syntax correctly
• Instructions are numbered steps, not vague paragraphs
• Output format is defined
• Rules section exists with boundaries

Step 4: Save and Test

1. Create directory: .claude/skills/<skill-name>/
2. Save SKILL.md to that directory
3. Instruct user to test: open Claude Code, type /<skill-name>

Frontmatter Reference

Field	Required	Description
name	Yes	Slash command name (lowercase, hyphens)
description	Yes	When to use (specific, <150 chars)
argument-hint	No	Autocomplete hint, e.g. [filename]
allowed-tools	No	Tools allowed without asking
disable-model-invocation	No	true = manual only
user-invocable	No	false = hidden from menu
model	No	Override model
effort	No	low, medium, high, max
context	No	fork for subagent isolation

Rules

• Follow existing skill patterns in this project
• Keep SKILL.md under 200 lines
• Use shell injection for context detection, not hardcoded assumptions
• Description must be specific enough for Claude to auto-invoke correctly