skill-creator

Skill Creator

Version: 1.0.0 Purpose: Create properly structured Claude Skills

Triggers

Skill Structure

.claude/skills/[skill-name]/
├── SKILL.md              # Required: Main instructions
├── resources/            # Optional: Reference docs
│   └── examples.md
└── scripts/              # Optional: Helper scripts
    └── helper.sh

Creation Process

Step 1: Gather Requirements

Ask:

1. Purpose: What does this skill do?
2. Triggers: When should it activate?
3. Input: What information is needed?
4. Output: What should be produced?
5. Tools: Which tools are needed?

Step 2: Create Directory

mkdir -p .claude/skills/[skill-name]

Step 3: Write SKILL.md

---
name: [skill-name]
description: [What it does]. Use when [trigger conditions].
allowed-tools: Bash, Read, Write
---

# [Skill Title]

**Version**: 1.0.0
**Purpose**: [Brief purpose]

---

## Triggers

| Trigger | Examples |
|---------|----------|
| [Category] | "[example1]", "[example2]" |

---

## Workflow

### Step 1: [Title]

[Instructions]

---

## Checklist

- [ ] [Item 1]
- [ ] [Item 2]

Naming Rules

Required

Forbidden

✅ GOOD: code-connector, task-runner
❌ BAD: claude-helper, mcp-server

Description Format

[What it does]. Use when [conditions].

Examples:

✅ GOOD: "Review code for bugs and security issues.
         Use when checking PRs or analyzing code quality."

❌ BAD: "A skill for code"
❌ BAD: "Helps with stuff"

Template

---
name: [kebab-case-name]
description: [Action verb] [object]. Use when [trigger condition 1], [trigger condition 2].
allowed-tools: Bash, Read, Write, Grep, Glob
---

# [Title with Emoji]

**Version**: 1.0.0
**Purpose**: [One-line purpose]

---

## Triggers

| Trigger | Examples |
|---------|----------|
| [Category 1] | "[EN example]", "[JP example]" |
| [Category 2] | "[EN example]", "[JP example]" |

---

## [Main Section]

### Step 1: [Title]

\`\`\`bash
# Command example
\`\`\`

### Step 2: [Title]

[Instructions]

---

## Best Practices

\`\`\`
✅ GOOD: [Recommended pattern]
❌ BAD: [Anti-pattern]
\`\`\`

---

## Checklist

- [ ] [Requirement 1]
- [ ] [Requirement 2]
- [ ] [Requirement 3]

Validation

# Check frontmatter
head -n 5 .claude/skills/[name]/SKILL.md

# Test trigger
# Ask Claude: "[trigger phrase]"
# Expected: Skill activates

Checklist

• Directory created at .claude/skills/[name]/
• SKILL.md has valid frontmatter
• Name is kebab-case, no forbidden words
• Description has action + trigger
• Triggers cover EN and JP
• Steps are clear and actionable