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

Read the skill documentation to understand capabilities and limitations.

Step 3: Apply Skill

Follow the workflow steps to apply the skill.

Step 4: Validate Results

Check that the skill achieved the intended outcome.

Best Practices

• Keep skills focused on a single domain or capability

• Include clear examples and use cases

• Document anti-patterns to avoid common mistakes

• Bundle resources when they add value

Anti-Patterns

• Creating overly broad skills that try to do everything

• Skipping the "When to Use" section

• Missing examples or use cases

• Not documenting bundled resources

Examples

Example 1: Basic Usage

Scenario: Creating a new skill for code review

Approach:

• Review this example skill structure

• Use the template from steve/templates/AGENT_SKILL.template.md

• Fill in domain-specific content

• Add bundled resources if needed

Reference Files

This skill includes reference files in references/ :

• structure-guide.md : Detailed structure guidelines

• examples.md : Additional examples