Check reference / Triggering & Discoverability

TRIGGER-02 Description long enough to anchor invocation

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

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

Why it matters

A description that reads like a title gives the model almost nothing to match user requests against — the skill installs fine and then never fires. Length is a crude but honest proxy: you cannot say what a skill does AND when to use it in a title.

How to fix it

Write past 100 characters with substance, not padding: what the artifact does, when to use it, and 2–3 phrases a user would actually say. The bands: under 40 chars fails (title-length), 40–99 warns (thin), 100+ passes.

Example

✗ flagged
Formats spreadsheet data.
✓ passes
Cleans and formats spreadsheet data — dedupes rows, normalizes dates, fixes number formats. Use when the user pastes messy CSV/Excel data or asks to "clean up this sheet".