What problem does it solve?
The Skill Mastery guide provides master-level guidance for creating exceptional Claude Code skills by integrating official plugin-dev toolkit, community patterns, and current API docs. Use when designing skill architecture, writing skill descriptions, or planning progressive disclosure.
Core Features & Use Cases
- Structured architecture guidance: outlines core folders, frontmatter requirements, and artifact layout to maximize token efficiency and maintainability.
- Patterns and templates: includes THE EXACT PROMPT pattern, Validation Loop, Risk Tiering, and other patterns to ensure reproducible, safe skill development.
- Archetype guidance and integration: shows how to combine CLI Reference, Methodology, Safety Tool, and Orchestration into hybrid Skill designs, with concrete examples.
- Use cases: from creating a new skill from scratch to auditing existing skills for quality and safety.
- Additional best practices: keep references shallow, ensure on-demand resources are properly linked.
Quick Start
Use the guide to scaffold a new skill:
- Identify your target archetype (CLI Reference, Methodology, Safety Tool, Orchestration).
- Draft SKILL.md with core guidance (<500 lines) and progressive disclosure plan.
- Initialise the skill structure with python scripts/init_skill.py <skill-name> --path <location>.
- Populate references/, assets/ with concise, one-level deep docs.
- Validate with plugin-dev's validators and package with python scripts/package_skill.py.