If the user's intent does not match the purpose of this skill, load plugin-creator:plugin-lifecycle to route to the right skill and process.

Write Frontmatter Description

A description is a context pointer: a line that names material the agent cannot see, and encodes the condition for reaching it. A model-invoked skill's description sits in the context window on every turn of every session, whether the skill fires or not. It is the only part of the skill that is always loaded, and it decides on its own whether the skill loads at all from among a hundred others.

So a description earns harder pruning than the body it points at. A word that does not help the agent decide reach it or not is paid for on every turn and returns nothing.

SOURCE: writing-for-agents (accessed 2026-09-13) — the pointer model, branch counting, and the no-op test. Adapted here to the description field specifically.

SOURCE: https://agentskills.io/skill-creation/optimizing-descriptions.md (accessed 2026-09-24) — imperative Use this skill when... phrasing.

The two jobs

A pointer does two things: it states what the material is, and it lists the branches that should trigger reaching it. A branch is a distinct case the skill handles — a path a run can take through it. Anything that is neither is waste.

Job 1 — name the material

Open with the verb the agent is scanning for, then its object. Generate conventional commit messages from staged git diffs names both in eight words.