---
name: write-a-skill
description: Turn a workflow you just ran by hand into a reusable Claude Skill (a SKILL.md with name, description and instructions) so you never re-explain it. Use after doing a multi-step task once that you know you will repeat.
---

# Write a Skill

## What it does
Watches how you just solved a task and packages it as a reusable skill, so the next run is one command instead of a long prompt.

## When to use
- Right after finishing a repeatable multi-step task.
- When you find yourself pasting the same context or instructions again.

## Instructions
1. Ask the user to describe (or point to) the workflow they just completed.
2. Draft a SKILL.md with: YAML frontmatter (a kebab-case name and a description that says what it does AND when to use it), then sections for What it does, When to use, Instructions, Output format, and the one mistake to avoid.
3. Keep the description trigger-focused: the model uses it to decide when to load the skill.
4. Point the user to the official format and examples so they can host it properly.

## Reference
The official Claude Skills format and examples: https://github.com/anthropics/skills

## Output format
- A complete, ready-to-save SKILL.md.
- A one-line install note (where to place it).

## The one mistake to avoid
A vague description. If it does not say clearly when to use the skill, the model will not trigger it at the right time.