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

name, description

name	description
skill-name	{{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.}}

{{code example}}

Option 2: {{Alternative}}

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

{{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}}