skill-mastery

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.