Writing Skills

House style for the skills in this repo. The agentskills.io spec covers the mechanics (frontmatter fields, file layout); this guide is the opinionated layer that comes from running these skills against real Mozilla CI work.

When in doubt, reach for /skill-creator — it covers the eval loop (scripts/run_loop.py) which this guide deliberately does not duplicate.

Description style

The description is a routing trigger, not documentation. It's loaded into every session, so every word costs the user every time. Aim for ≤50 words.

Required shape:

1. One sentence on what the skill does and what tool it wraps. Be concrete — "via paperctl v2.0", "using the bq CLI", "via browser-harness against an authenticated Chrome tab" — not "queries