ai-search-optimization

ai-search-optimization is a skill for Claude Code, Codex from cbrock84/headcount. It costs 79 tokens per session (598 once invoked), scanned A, original, MIT.

A writing guide for making web pages easy for AI assistants to find, understand, quote, and represent accurately. It focuses on content that can stand on its own when an AI retrieves only one section.

In plain words
What is it for?
Use it to plan or revise pages for AI search: write question-based headings, answer them directly, define terms, keep facts consistent, and show authorship and sources.
Why use it?
It helps when people get answers from AI instead of clicking search links, or when AI answers omit or misstate a brand. It replaces vague, context-dependent writing with clear answers, facts, sources, and structure.

Skill for Claude CodeCodex

Part of the demand-generation plugin — 12 skills shipped together

About the project

headcount is an organization of independently installable Claude Code plugins, each grouping skills for a department such as finance, security, or demand generation. Claude Code users install the departments they need and invoke their skills for specialized work; the catalogue entries are skills and related agent tooling from that organization.

cbrock84/headcount · 1,247 stars · on GitHub

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/cbrock84/headcount/ai-search-optimization
Any agent
npx skills add cbrock84/headcount --skill ai-search-optimization
Clone the repo
git clone --depth 1 https://github.com/cbrock84/headcount

Made for: Claude Code, Codex.

Or install demand-generation, the plugin that ships this one along with the rest of its 12 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for ai-search-optimization

README.md
[![agentmods](https://agentmods.dev/badge/skills/cbrock84/headcount/ai-search-optimization.svg)](https://agentmods.dev/skills/cbrock84/headcount/ai-search-optimization)
Your own site
<a href="https://agentmods.dev/skills/cbrock84/headcount/ai-search-optimization"><img src="https://agentmods.dev/badge/skills/cbrock84/headcount/ai-search-optimization.svg" alt="Measured on agentmods" height="20"></a>
Per session 79 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 598 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00079 $0.00598
Opus 5 $0.00039 $0.00299
Sonnet 5 $0.00016 $0.00120
Haiku 4.5 $0.00008 $0.00060

Measured yesterday against content hash 4f39648c3488, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

ai-search-optimization scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/demand-generation/skills/ai-search-optimization/SKILL.md · 53 lines

How it starts

The opening of the file, as written. The whole thing — 53 lines — stays where its author put it; the contents beside it link to each section on GitHub.

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.

Read the full file on GitHub · 53 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday Changed · +6 lines 4f39648c3488
  2. 5d ago First seen · 47 lines · 79 tokens per session scan A 1a8b6daedbf5

Subscribe to this mod's changes

ai-search-optimization is a skill published in the GitHub repository cbrock84/headcount (1,247 stars, last pushed 2d ago), licensed MIT. It adds 79 tokens to every session and 598 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

save

Save durable decisions, findings, plans, and implementation knowledge from the visible Codex conversation into a new or existing NeatContext context. Use only when the user explicitly invokes this skill or asks to preserve the current conversation as reusable context.

XTSoftwareLabs/neatcontext-plugins · 49 tokens

mode

Show or set NeatContext routing to auto, ask, or manual for Codex, with an optional default shared with every other NeatContext host. Use only when the user explicitly invokes this skill or clearly asks to change routing behavior.

XTSoftwareLabs/neatcontext-plugins · 50 tokens

status

Report the NeatContext context and routing mode active in Codex, including missing-file or stale-routing warnings. Use when the user asks which context is connected or explicitly invokes this skill.

XTSoftwareLabs/neatcontext-plugins · 39 tokens

list

List the local NeatContext Contexts available to Codex. Use when the user asks what contexts exist, what can be connected, or explicitly invokes this skill.

XTSoftwareLabs/neatcontext-plugins · 35 tokens

build-oxpecker-web-app

Build or modify an Oxpecker web application in idiomatic F#, using endpoint routing, functional EndpointHandler and EndpointMiddleware composition, ASP.NET Core metadata, and focused endpoint tests.

gaelic-ghost/socket · 44 tokens

dns

This skill should be used when the user asks about "DNS", "domain resolution", "GeoDNS / geo routing", "latency-based routing", "weighted / failover routing", "Route 53 / Cloud DNS", an "A/CNAME/ALIAS record", "anycast", or "DNS TTL / propagation". It gives the global front door that maps a name to the right IP and…

proyecto26/system-design-skills · 131 tokens