claude-skills

1# Claude Skills Meta-Skill
2 
3Turn scattered domain material into a Skill that is reusable, maintainable, and reliably activatable:
4- `SKILL.md` as the entrypoint (triggers, constraints, patterns, examples)
5- `references/` for long-form evidence and navigation
6- optional `scripts/` and `assets/` for scaffolding and templates
7 
8## When to Use This Skill
9 
10Trigger this meta-skill when you need to:
11- Create a new Skill from scratch from docs/specs/repos
12- Refactor an existing Skill (too long, unclear, inconsistent, misfires)
13- Design reliable activation (frontmatter + triggers + boundaries)
14- Extract a clean Quick Reference from large material
15- Split long content into navigable `references/`
16- Add a quality gate and a validator
17 
18## Not For / Boundaries
19 
20This meta-skill is NOT:
21- A domain Skill by itself (it builds domain Skills)
22- A license to invent external facts (if the material does not prove it, say so and add a verification path)
23- A substitute for required inputs (if inputs are missing, ask 1-3 questions before proceeding)
24 
25## Quick Reference
26 
27### Deliverables (What You Must Produce)
28 
29Your output MUST include:
301. A concrete directory layout (typically `skills/<skill-name>/`)
312. An actionable `SKILL.md` with decidable triggers, boundaries, and reproducible examples
323. Long-form docs moved to `references/` with a `references/index.md`
334. A pre-delivery checklist (Quality Gate)
34 
35### Recommended Layout (Minimal -> Full)
36 
37```
38skill-name/
39…