name: my-skill description: Brief one-line description of what this skill does tags: [category, use-case] version: 1.0.0 author: your-name

Skill Name

Overview

Provide a clear, concise overview of what this skill accomplishes.

When to Use

Describe the scenarios where this skill should be invoked:

• Scenario 1: When...
• Scenario 2: If the user asks for...
• Scenario 3: During...

Prerequisites

List any requirements or setup needed:

• Tool availability (e.g., requires git tool)
• File existence (e.g., requires package.json)
• Environment variables (e.g., requires API_KEY)

Instructions

Step 1: [Action Name]

Detailed instructions for this step.

# Example command if needed
command --flags arguments

Step 2: [Action Name]

Next step instructions.

Step 3: [Action Name]

Final step instructions.

Expected Output

Describe what the successful completion looks like:

• Files created: ...
• Output format: ...
• Success criteria: ...

Error Handling

Common issues and how to resolve them:

• Error: Description
  • Cause: Why it happens
  • Fix: How to resolve

Examples

Example 1: [Use Case]

User request: "Please [task description]"

Skill invocation:
1. Step 1 action
2. Step 2 action
3. Result: [expected outcome]

Example 2: [Use Case]

User request: "Can you [task description]"

Skill invocation:
1. Step 1 action
2. Step 2 action
3. Result: [expected outcome]

Resources

Reference any helper scripts or templates included with this skill:

• scripts/helper.sh - Description of what it does
• templates/config.yaml - Description of template
• examples/sample.txt - Example file

Notes

Any additional context, tips, or warnings:

• Note 1
• Note 2

Version History

• 1.0.0 (YYYY-MM-DD): Initial release