Claude Skill Developer Guide
Provides a standardized reference and template for creating high-quality Claude Code plugin skills.
Key features
- Example repository layouts and organization patterns
- Detailed frontmatter field documentation
- Guidance on skill directory and file structure
- Best practices for writing effective model triggers
- Standardized SKILL.md template generation
Use cases
- Understanding the architectural difference between skills, commands, and agents
- Optimizing skill descriptions to improve model invocation accuracy
- Bootstrapping a new Claude Code plugin skill with a valid template
FAQ
Can I include more than just a markdown file in a skill?
Yes, skill directories can contain supporting files like READMEs, reference materials, examples, and helper scripts to provide deeper context.
Why is the description field in SKILL.md so important?
The description acts as the trigger mechanism; it tells Claude exactly which keywords or user intents should cause the skill to be activated.
How do I trigger this specific skill?
This skill activates when you ask Claude to demonstrate skill formats, create a skill template, or discuss skill development patterns.
What is the difference between a skill and a command?
Commands are explicitly invoked by the user, while skills are contextually and autonomously invoked by Claude based on the task requirements.
What is a Claude Code Skill?
A skill is a specialized capability that provides domain-specific guidance and patterns for Claude to follow during autonomous tasks, improving its behavior in specific contexts.
Related skills
Axiom Getting Started
Guides new users to the most relevant Axiom skills for their project and development focus through an interactive onboarding experience.
Learning Documentation5212 ptsSkill Making
Creates and refines Claude agent skills by providing established best practices, structural guidelines, and development workflows.
Learning Documentation1712 ptsSkill Creator
Guides the creation of new, effective Claude Code Skills with best practices and structured workflows.
Learning Documentation29812 pts