A skill that teaches Claude how to write production-quality skills — the folders of instructions that customize Claude for specific tasks and workflows.
Built entirely from Anthropic's official guide, this skill covers frontmatter craft, progressive disclosure architecture, workflow patterns, validation, and troubleshooting. Install it once and Claude becomes an expert skill author across all your conversations.
Pick whichever method matches your setup:
npx skills add arch1904/expert-skill-writer/plugin marketplace add arch1904/expert-skill-writer
/plugin install expert-skill-writer
Clone this repo and copy the skill folder:
git clone https://github.com/arch1904/expert-skill-writer.git
cp -r expert-skill-writer/skills/expert-skill-writer ~/.claude/skills/- Download
expert-skill-writer.zipfrom the latest release - Go to Settings → Capabilities → Skills
- Click Upload skill and select the zip
When you ask Claude to write, review, or improve a skill, this skill activates and walks through a structured process:
- Understand intent — clarifies use cases, triggers, expected output, and skill category
- Design architecture — plans folder structure, progressive disclosure levels, composability
- Write frontmatter — crafts the description field (the most important part) with proper trigger phrases
- Write instructions — produces specific, actionable skill content with error handling and examples
- Review and validate — runs through a quality checklist covering structure, content, triggering, and distribution
| File | Purpose |
|---|---|
SKILL.md |
Core instructions — the skill itself (321 lines) |
references/frontmatter-spec.md |
Complete YAML frontmatter specification with good/bad examples |
references/skill-categories.md |
Three skill categories with real-world examples and the kitchen analogy |
references/workflow-patterns.md |
Five proven workflow patterns (sequential, multi-MCP, iterative, context-aware, domain intelligence) |
references/quality-checklist.md |
Pre-upload and post-upload validation checklist |
references/troubleshooting.md |
Common issues: undertriggering, overtriggering, MCP failures, instructions not followed |
scripts/validate_skill.py |
Programmatic validator — checks naming, frontmatter, structure against the spec |
scripts/scaffold_skill.py |
Generates a new skill folder with correct structure |
After installing, test with prompts like:
- "Write a skill that helps Claude generate unit tests for Python projects"
- "Review this SKILL.md and suggest improvements" (paste or upload your skill)
- "I have a Notion MCP connected — help me build a skill for project setup workflows"
- "Turn this conversation into a reusable skill"
Anthropic's built-in skill-creator focuses on eval/benchmark iteration — running test cases, grading outputs, and improving skills through automated loops. This skill focuses on the writing craft: producing well-structured, effective skill content that triggers reliably and follows Anthropic's official best practices. They're complementary — use skill-creator for iteration, use expert-skill-writer for authoring.
100% based on The Complete Guide to Building Skills for Claude (Anthropic, January 2026). No external sources or invented guidance.