name: your-skill-name description: A clear, concise description of what your skill does and when Claude should use it. Include the main functionality and use cases. version: 1.0.0

Your Skill Name

A brief introduction to what this skill does and the problem it solves.

YAML Frontmatter Requirements

Every skill must include YAML frontmatter at the top of SKILL.md with the following required fields:

• name: Unique identifier for your skill in kebab-case (e.g., markdown-optimizer)
• description: Clear, concise description of what your skill does and when Claude should use it
• version: Semantic version number (e.g., 1.0.0) following SemVer format
  • MAJOR version for incompatible changes
  • MINOR version for backwards-compatible functionality additions
  • PATCH version for backwards-compatible bug fixes

Example:

---
name: my-awesome-skill
description: Helps users accomplish X by doing Y. Use when working with Z scenarios.
version: 1.0.0
---

When to Use This Skill

Describe the scenarios where this skill should be activated:

• Use case 1
• Use case 2
• Use case 3

Core Functionality

Feature 1

Describe the first major feature or capability:

# Example command or usage pattern
command-example

Explanation of what this does.

Feature 2

Describe the second major feature:

# Example code if applicable
def example_function():
    pass

Feature 3

Additional features or capabilities.

Workflow

Describe the typical workflow for using this skill:

1. Step 1: First action
2. Step 2: Second action
3. Step 3: Final step

Configuration (Optional)

If your skill requires configuration, document it here:

# Example configuration
setting_name: value
option: enabled

Best Practices

Do:

• Recommended practice 1
• Recommended practice 2
• Recommended practice 3

Don't:

• Anti-pattern 1
• Anti-pattern 2

Examples

Example 1: Basic Usage

User: "Help me [task description]"
Claude: [Expected behavior using this skill]

Example 2: Advanced Usage

Show more complex usage patterns.

Integration with Other Skills

Explain how this skill works with or complements other skills in the marketplace.

Reference Files

If your skill includes reference files, describe them:

• references/file1.md - Description
• scripts/script.py - Description

Troubleshooting

Common issues and solutions:

Issue: Problem description Solution: How to fix it

Additional Resources

• Link to external documentation (if applicable)
• Related tools or libraries
• Further reading