Writing Skills
Gotchas
- Generic description — "Helps with X" gives the agent no way to distinguish this skill. Always include a concrete
Use when [specific triggers]clause with keywords the agent will see in real requests. - Missing trigger keywords — if the description omits the words users naturally say ("triage", "handover", "cleanup"), the skill never loads. Test: would the description match the user's message verbatim?
- Over-stuffed SKILL.md — dumping all edge cases
[Description truncada. Veja o README completo no GitHub.]