Example Skill
A meta-reference for building other skills. Shows you the expected YAML frontmatter, how to structure sections like "When to Use" and "What This Skill Does", and demonstrates progressive disclosure from overview to detailed workflows. Includes bundled reference files and covers both best practices and anti-patterns to avoid. Honestly, this is most useful when you're creating your first few skills and need a template to copy from. Once you've built a couple, you probably won't need to reference it again unless you're helping someone else get started or forgot the exact section ordering.
- GitHub stars
- 352
- last updated
- Jun 11, 2026
Install
$ npx -y skills add aiskillstore/marketplace --skill example-skill --agent claude-codeInstalls into .claude/skills of the current project.
Files
Example Skill
A demonstration skill showing the proper structure and format for Claude Code skills.
When to Use This Skill
- Creating new skills and need a reference
- Understanding skill structure and best practices
- Learning how to bundle resources with skills
What This Skill Does
- Demonstrates proper YAML frontmatter format
- Shows content structure requirements
- Provides examples of bundled resources
- Illustrates best practices for skill documentation
Core Principles
Principle 1: Clear Purpose
Skills should have a clear, well-defined purpose. The "When to Use" section should make it obvious when to apply the skill.
Principle 2: Progressive Disclosure
Structure content from high-level overview to detailed implementation. Start with "When to Use" and "What This Skill Does" before diving into workflows.
Principle 3: Actionable Workflows
Provide step-by-step workflows that can be followed directly. Include examples and anti-patterns.
Workflow
Step 1: Identify Need
Determine if this skill is appropriate for the current task.
Step 2: Review Documentation
Sponsors
Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthly
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any language
Agent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/aiskillstore/marketplace
- First seen
- Jun 11, 2026
