create-skill
Expert guidance for creating, writing, building, and refining GSD skills. Use when working with SKILL.md files, authoring new skills, improving existing skills, or understanding skill structure and best practices.
Best for skill authorsWorks with GitHubLow risk
⌘source
- author
@gsd-build- repo
- gsd-build/gsd-2
- language
- TypeScript
★7.2kstars
737forks
May 6, 2026
✦overview.md
Key Features
- ·Modular filesystem-based skills
- ·XML-structured prompts
- ·Router pattern for complex skills
- ·Separate workflows, references, templates
Use Cases
- →Creating a new GSD skill from scratch
- →Refactoring an existing skill to use the router pattern
- →Learning best practices for skill authoring
Best for
- ✓skill authors
- ✓platform developers
Not ideal for
- !users not creating skills
FAQs
name
create-skill
description
Expert guidance for creating, writing, building, and refining GSD skills. Use when working with SKILL.md files, authoring new skills, improving existing skills, or understanding skill structure and best practices.
<essential_principles>
How Skills Work
Skills are modular, filesystem-based capabilities that provide domain expertise on demand. This skill teaches how to create effective skills.
1. Skills Are Prompts
All prompting best practices apply. Be clear, be direct, use XML structure. Assume Claude is smart - only add context Claude doesn't have.
2. SKILL.md Is Always Loaded
When a skill is invoked, Claude reads SKILL.md. Use this guarantee:
- Essential principles go in SKILL.md (can't be skipped)
- Workflow-specific content goes in workflows/
- Reusable knowledge goes in references/
3. Router Pattern for Complex Skills
skill-name/
├── SKILL.md # Router + principles
├── workflows/ # Step-by-step procedures (FOLLOW)
├── references/ # Domain knowledge (READ)
├── templates/ # Output structures (COPY + FILL)
└── scripts/ # Reusable code (EXECUTE)
SKILL.md asks "what do you want to do?" → routes to workflow → workflow specifies which references to read.
When to use each folder:
- workflows/ - Multi-step procedures Claude follows
- references/ - Domain knowledge Claude reads for context
$install
1-click copynpx skills add gsd-build/gsd-2 --skill create-skillSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
4/ 5
very goodClear and well structured, with only minor parts that might need a second read.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
4/ 5
highMostly actionable with clear steps; only a few small gaps remain.