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."

  1. Open with the trigger: "Use when…".
  2. Name concrete situations, not abstractions.
  3. Include the words users actually type — synonyms count.
  4. 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).