Writing Skills

---
name: writing-skills
description: Create or refine a reusable SKILL.md workflow in the harness's discoverable skills directories.
---

Choose a narrow, repeatable task that benefits from instructions beyond the agent's general capabilities. Inspect nearby skills and the existing tool surface before adding another workflow.

Create a folder named for the skill with a SKILL.md containing YAML frontmatter: a lowercase hyphenated name and a description that says what it does and when to use it. Keep the body focused on decisions, required inputs, observable outcomes, and constraints. Use existing tools and filesystem conventions; a skill does not introduce a new tool or grant authority.

Delete duplicated prompt instructions and generic advice. Add supporting files only when they supply necessary detail or reliable reusable execution, and link them where needed. Exercise the workflow on representative tasks when permitted, including a case that should not activate it. Separate format validation from evidence that the workflow works; preserve user edits when revising an existing skill.