| name | skill-writing |
| description | Use when creating or updating agent skills (`skills/<name>/SKILL.md` files). |
Skill Writing
Requirements
You must fetch and follow the latest Agent Skills specification before writing or updating a skill:
curl -fsSL https://agentskills.io/specification.md
- Use valid frontmatter with:
name (matches the skill directory name)
description (clear usage trigger; agents only receive this info to decide whether to use the skill)
- Reference files as relative paths from skill root without dot-slash prefixes.
- Prefer
scripts/example.sh style paths.
- Keep file references one level deep where practical (for example
scripts/tool.sh, docs/example.md).
- Keep instructions concise and action-oriented.
Author checklist
Before finalizing a skill update:
- Confirm frontmatter is present and valid.
- Confirm all file/path examples are relative and do not use dot-slash prefixes.
- Confirm usage trigger in
description is explicit.
- Confirm examples and commands are executable as written.
- Confirm wording is concise and implementation-focused.