Description Examples

Good descriptions carry WHAT + WHEN + trigger terms, third person.

# Code review
description: Reviews diffs for bugs, security, and maintainability against team standards. Use when reviewing pull requests, diffs, or when the user asks for a code review.
# Commit helper (explicit only; pair with disable-model-invocation: true)
description: Generates commit messages from git diffs in team format. Use when the user asks for a commit message or staged-change summary.
# PDF work
description: Extracts text/tables from PDFs, fills forms, merges documents. Use for PDF files, forms, or document extraction.

Checklist: third person, specific verbs, 2-4 trigger terms, no overlap with sibling skill descriptions.