claude-skills

Claude Skills Meta-Skill

Turn scattered domain material into a Skill that is reusable, maintainable, and reliably activatable:

• SKILL.md as the entrypoint (triggers, constraints, patterns, examples)
• references/ for long-form evidence and navigation
• optional scripts/ and assets/ for scaffolding and templates

When to Use This Skill

Trigger this meta-skill when you need to:

• Create a new Skill from scratch from docs/specs/repos
• Refactor an existing Skill (too long, unclear, inconsistent, misfires)
• Design reliable activation (frontmatter + triggers + boundaries)
• Extract a clean Quick Reference from large material
• Split long content into navigable references/
• Add a quality gate and a validator

Not For / Boundaries

This meta-skill is NOT:

• A domain Skill by itself (it builds domain Skills)
• A license to invent external facts (if the material does not prove it, say so and add a verification path)
• A substitute for required inputs (if inputs are missing, ask 1-3 questions before proceeding)

Quick Reference

Deliverables (What You Must Produce)

Your output MUST include:

1. A concrete directory layout (typically skills/<skill-name>/)
2. An actionable SKILL.md with decidable triggers, boundaries, and reproducible examples
3. Long-form docs moved to references/ with a references/index.md
4. A pre-delivery checklist (Quality Gate)

Recommended Layout (Minimal -> Full)

skill-name/
|-- SKILL.md              # Required: entrypoint with YAML frontmatter
|-- references/           # Optional: long-form docs/evidence/index
|   `-- index.md          # Recommended: navigation index
|-- scripts/              # Optional: helpers/automation
`-- assets/               # Optional: templates/configs/static assets

The truly minimal version is just SKILL.md (you can add references/ later).

YAML Frontmatter (Required)

---
name: skill-name
description: "What it does + when to use (activation triggers)."
---