claude-skills-reference/engineering-team/self-improving-agent/templates/skill-template.md

---
name: {{skill-name}}
description: "{{One-line description}}. Use when: {{trigger conditions}}."
---

# {{Skill Title}}

> {{One-line value proposition}}

## Quick Reference

| Problem | Solution |
|---------|----------|
| {{error/symptom 1}} | {{fix 1}} |
| {{error/symptom 2}} | {{fix 2}} |

## The Problem

{{2-3 sentences explaining what goes wrong and why.
Include the exact error message if applicable.}}

## Solutions

### Option 1: {{Name}} (Recommended)

{{Step-by-step instructions.}}

```{{language}}
{{code example}}
```

### Option 2: {{Alternative}}

{{When Option 1 doesn't apply.}}

```{{language}}
{{code example}}
```

## Trade-offs

| Approach | Pros | Cons |
|----------|------|------|
| Option 1 | {{pros}} | {{cons}} |
| Option 2 | {{pros}} | {{cons}} |

## Edge Cases

- {{edge case and how to handle it}}

## Related

- {{link to official docs}}