Writing skills your agent will actually reuse

The pattern

If you have typed the same instruction three times, it belongs in a skill rather than in a prompt. Placeholder content — replace with the real write-up.

Structure

Keep each skill to one job, written as rules rather than prose.

---
name: release-notes
description: Draft release notes from merged pull requests
---
Write in plain language. No emoji. One line per change.

Testing it

Run the same request twice in a fresh session. If the output drifts, your skill is describing taste rather than rules.