Check reference / Correctness & Structure
STRUCT-02 Recommended fields present
Deterministic — runs on every scan, no LLM or network needed.
Why it matters
The `description` is what the model reads when deciding whether to invoke your skill — without one the skill is effectively invisible and never triggers (for commands, /help and the SlashCommand tool show nothing). A missing `name` is softer: the skill silently falls back to its directory name.
How to fix it
Add a non-empty `description` that leads with the key use case and the phrases a user would actually say, plus an explicit `name`. Slash commands only need `description` — they are named by their filename.
Example
✗ flagged
---
name: sql-formatter
--- <- no `description`, so the model has nothing to match against✓ passes
---
name: sql-formatter
description: Formats SQL files. Use when the user asks to format, lint, or clean up SQL.
---