Skill Name

---
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.

```bash
# 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