Check reference / Triggering & Discoverability

TRIGGER-03 Invocation cues in the description

Triggering & Discoverability · 22% of the grade · deterministic · applies to skills · subagents

Deterministic — runs on every scan, no LLM or network needed.

Why it matters

Pure what-it-does prose makes the model guess when to invoke your skill — and a guessing model usually guesses "not now". Descriptions that state the trigger explicitly reliably out-fire ones that only describe capability.

How to fix it

State the trigger in so many words. This check looks for explicit cues: "use when/after/before/if/for …", "triggers on …", "when the user …", or a quoted phrase a user would actually say. One cue passes; zero warns.

Example

✗ flagged
A comprehensive formula generator supporting Excel and Google Sheets.
✓ passes
Generates Excel/Sheets formulas. Use when the user asks "what formula do I need" or pastes a formula that returns an error.