.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:

Purpose: What does this skill do?
Triggers: When should it activate?
Input: What information is needed?
Output: What should be produced?
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

Rule	Example
Kebab-case	`my-skill`
Lowercase	`code-reviewer`
Descriptive	`test-generator`

Forbidden

Word	Reason
`claude`	Trademark
`anthropic`	Company name
`mcp`	Protocol name

✅ 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

Trigger	Examples
Create	"create a skill", "スキル作成", "make new skill"
Package	"package this workflow", "ワークフロー化"
Automate	"automate this process", "自動化"

skill-creator

Skill Creator

Triggers

Skill Structure

More from shunsukehayashi/miyabi

ccg

doc-generator

agent-skill-use

commit-helper

refactor-helper

code-reviewer