# your-skill-name > A clear, concise description of what your skill does and when Claude should use it. Include the main functionality and use cases. - Author: Michael VanDyke - Repository: mvdmakesthings/skills - Version: 20260113155158 - Stars: 0 - Forks: 0 - Last Updated: 2026-02-06 - Source: https://github.com/mvdmakesthings/skills - Web: https://mule.run/skillshub/@@mvdmakesthings/skills~your-skill-name:20260113155158 --- --- 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](https://semver.org/) format - MAJOR version for incompatible changes - MINOR version for backwards-compatible functionality additions - PATCH version for backwards-compatible bug fixes Example: ```yaml --- 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: ```bash # Example command or usage pattern command-example ``` Explanation of what this does. ### Feature 2 Describe the second major feature: ```python # 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: ```yaml # 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