---

name: skill-name description: Clear, concise description of what this skill does and when to use it (1-1024 chars). Include relevant keywords for agent discovery. license: MIT compatibility: Works with Claude Code and OpenAI Codex. List any specific requirements (packages, network access, etc.) metadata: category: general tags: tag1, tag2, tag3 version: "0.1.0"

Skill Name

Overview

Brief overview of what this skill accomplishes and its purpose.

When to Use

Describe the specific scenarios where this skill should be invoked:

• Scenario 1
• Scenario 2
• Scenario 3

Process

Step-by-step instructions for the agent to follow:

Step 1: Preparation

What the agent should do first.

Step 2: Main Action

Core workflow steps.

Step 3: Validation

How to verify success.

Guidelines

Best practices or constraints:

• Guideline 1
• Guideline 2
• Guideline 3

Examples

Example 1: Basic Usage

Describe a common use case and expected behavior.

Example 2: Advanced Usage

Show a more complex scenario.

Troubleshooting

Common issues and solutions:

Issue: Problem description Solution: How to fix it

Additional Resources

For detailed examples, see references/EXAMPLES.md (if you create it). For supplementary documentation, see references/REFERENCE.md.