Step 1 of 5
The Anatomy of a Great Description
Write descriptions that route the right requests to your skill.
The description is a matching surface, not a summary. Claude compares the user's intent to it, so it should be dense with the situations and vocabulary that signal "this task is mine."
- Open with the trigger: "Use when…".
- Name concrete situations, not abstractions.
- Include the words users actually type — synonyms count.
- Add an explicit boundary when a look-alike skill exists ("Do NOT use for…").
description: Use when auditing or improving a page's visibility in AI
search (ChatGPT, Perplexity, AI Overviews). Triggers on "AEO audit",
"are we cited in ChatGPT", "llms.txt". Does NOT cover blue-link SEO
(use seo-audit) or Core Web Vitals (use site-performance-audit).