references/description-optimization.md
Description Optimization
Use this path to improve skill triggering quality and reduce false matches.
Trigger quality loop
- Draft a description with realistic user language and concrete trigger phrases.
- Build two query sets:
- should-trigger queries
- should-not-trigger queries
- Check the current description against both sets.
- Edit description wording to improve precision/recall.
- Repeat until false positives and false negatives are reduced to acceptable levels.
Authoring rules
- Keep the description in third person.
- Include what the skill does and when to use it.
- Avoid implementation details that do not help triggering.
- Avoid provider-specific phrasing unless the skill is intentionally provider-specific.
- For provider-agnostic skills, avoid naming Claude, Codex, or any provider in ways that would narrow portability expectations.
Required output
- Final description text
- should-trigger query set
- should-not-trigger query set
- Summary of edits made to improve trigger behavior