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

View on GitHub

Install

$ npx -y skills add aiskillstore/marketplace --skill example-skill --agent claude-code

Installs 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.