write-a-skilllisted
Install: claude install-skill kimgoetzke/coding-agent-configs
# Writing skills
## Process
1. **Gather requirements** - ask user about:
- What task/domain does the skill cover?
- What specific use cases should it handle?
- Does it need executable scripts or just instructions?
- Any reference materials to include?
2. **Draft the skill** - create:
- SKILL.md with concise instructions
- Additional reference files, if required
- Utility scripts if deterministic operations needed
3. **Review with user** - present draft and ask:
- Does this cover your use cases?
- Anything missing or unclear?
- Should any section be more/less detailed?
## Skill structure
```
skill-name/
├── SKILL.md # Main instructions (required)
├── reference.md # Detailed docs (if needed)
├── examples.md # Usage examples (if needed)
├── scripts/ # Scripts (if needed)
│ └── helper-script.sh # Utility script (if needed)
└── templates/ # Templates (if needed)
├── template-1.md
└── template-2.md
```
## SKILL.md template
```md
---
name: skill-name
description: Brief description of capability. Use when [specific triggers].
---
# Skill name
## Quick start
[Minimal working example]
## Workflows
[Step-by-step processes with checklists for complex tasks]
## Advanced features
[Link to separate files: See [reference.md](reference.md)]
```
## Description requirements
The description is **the only thing your agent sees** when deciding which skill to load. It's surfaced i