claude-skill-creator

# Claude Skill Creator

Comprehensive guide for authoring high-quality Claude skills.

## CRITICAL RULES - READ BEFORE CREATING ANY SKILL

**These rules are NON-NEGOTIABLE. Violating them wastes tokens and breaks skills.**

### Rule 1: START SMALL
- **Maximum files for new skill: 3** (SKILL.md + 2 supporting)
- Only add more files after the skill works

### Rule 2: NO PLACEHOLDERS
- **NEVER create empty files**
- **NEVER reference files you haven't written**
- If you write `See [guide.md]`, then guide.md MUST exist with content

### Rule 3: COMPLETE BEFORE LINKING
- Write the referenced file BEFORE adding the link to SKILL.md
- Test that each referenced file exists and has content

### Rule 4: FILE COUNT LIMITS

| Complexity | Max Files | When to Use |
|------------|-----------|-------------|
| Simple | 1-3 | Most skills |
| Moderate | 4-6 | Multi-domain skills |
| Complex | 7-10 | Rare, justify each file |
| **15+ files** | **NEVER** | **You are over-engineering** |

### Before Creating ANY File, Ask:
1. Can this fit in SKILL.md? - Do that
2. Will I complete this file RIGHT NOW? - If no, don't create it
3. Am I anticipating future needs? - Stop. Solve current problem only.

**Detailed anti-pattern examples**: See [references/anti-patterns.md](references/anti-patterns.md)

---

## Latest Official Documentation

Before creating skills, fetch current Anthropic specifications:

### Primary: Context7
1. Resolve: `mcp__context7__resolve-library-id` with "claude code skills"
2. Fetch: `mcp__context7__get-library-docs` with ID `/websites/code_claude_en` topic "skills"

### Fallback: WebFetch
```
WebFetch url="https://code.claude.com/docs/en/skills"
prompt="Extract skill file structure, frontmatter requirements, and best practices"
```

**Complete retrieval guide**: See [references/doc-retrieval.md](references/doc-retrieval.md)

---

## Core Principles

### The Context Window is a Public Good

Your skill shares context with system prompt, conversation history, other skills,