ucsandman/claude-skills / ai-search-optimization
ai-search-optimization
VerifiedImprove retrieval, citations, and accurate representation in AI search answers.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.6 KB |
SKILL.md
View on GitHub---
name: ai-search-optimization
description: "Improve retrieval, citations, and accurate representation in AI search answers."
---
# AI search optimization
Classical SEO optimizes to be *clicked*. This optimizes to be *quoted* — often with no click at all.
That changes what a good page looks like.
## What gets cited
- **Self-contained passages.** A retrieved chunk arrives without the surrounding page. Each section
must make sense alone, with its subject named rather than pronominalized.
- **Direct answers near the question.** Bury the answer under three paragraphs of context and the
passage retrieved will be the context.
- **Specific, checkable facts** — numbers, dates, named methods, stated conditions. Vague claims are
neither retrievable nor quotable.
- **Attributable expertise.** Named authors, stated credentials, dated content, and cited sources.
Anonymous undated content is weakly weighted.
- **Structure that survives extraction** — real headings, real lists, real tables. Layout implied by
styling disappears.
## Practical moves
- Answer the question in the first sentence under each heading, then elaborate.
- Write headings as the questions people actually ask.
- Define your own terms on your own pages, so the model's definition traces to you.
- Keep facts consistent across your site. Contradictions get resolved against you.
- Maintain the boring canonical pages — pricing, comparisons, specifications, FAQ. These are heavily
retrieved and usually neglected.
## Being represented accurately
Assistants assemble an answer about you from whatever is available, weighted toward third-party and
structured sources. Where those are thin or stale, the answer will be wrong.
Audit periodically: ask several assistants what your company does, who it is for, what it costs, and
how it compares. Note the errors and trace them to a source. The fix is almost always publishing or
correcting the source, not the assistant.
## Measuring
Click-through will fall on informational queries even as influence rises. Track citation and mention
frequency, and downstream branded search and direct traffic, rather than judging this program on
organic sessions — that metric will say you are losing while you are winning.
## Never
- Optimize for one assistant's current behavior. Retrieval and citation rules change without notice and without a changelog.
- Assume being crawlable means being citable. Models cite sources that answer a question cleanly, not sources that merely exist.
- Leave an inaccurate representation uncorrected because it is not on your site. The claim propagates whether or not you own the page it came from.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |