| name | search-visibility |
| description | Audit and improve qualified discovery across traditional and AI search. Use for SEO or indexing problems, ranking declines, AI citations and recommendations, GEO/AEO, content discoverability, or scalable programmatic-search opportunities. |
Search Visibility
Improve qualified discovery and demand capture. Treat traditional search, AI
answers, and scalable pages as related surfaces with different evidence and
failure modes.
Start with context
Read .agents/product-marketing.md when present. Also accept the older
.claude/product-marketing.md and product-marketing-context.md locations.
Ask only for task-specific information that is still missing.
Choose the route
- For crawling, indexing, technical SEO, on-page issues, or ranking loss, read
seo-audit.md.
- For AI Overviews, ChatGPT, Perplexity, Claude, citations, recommendations, or
machine-readable content, read ai-search.md.
- For directories, comparison pages, integrations, locations, or other
template-and-data opportunities, read
programmatic-seo.md.
Use more than one route when the problem crosses surfaces, but do not load all
references by default.
Shared workflow
- Define the audience, query or job, conversion outcome, geography, and
relevant search surfaces.
- Establish a baseline from live results, crawl/index data, analytics, and
cited sources. Separate observed evidence from inference.
- Fix access, rendering, indexing, canonicalization, and measurement before
optimizing copy or generating pages.
- Match intent with a genuinely useful page, clear answer structure,
first-party evidence, explicit entities, and attributable claims.
- Evaluate authority and off-site consensus. A citation is not necessarily a
recommendation or a qualified visit.
- Prioritize actions by expected business impact, confidence, effort, and
reversibility. Give the smallest useful next test first.
- Define leading and lagging measures: crawl/index coverage, qualified
impressions, citations or mentions, visits, conversions, and revenue.
Guardrails
- Do not promise rankings, traffic, citations, or inclusion in AI answers.
- Do not create thin pages at scale; require unique data, utility, or insight.
- Verify current platform behavior with primary sources when it may have
changed. Label benchmarks and causal explanations as estimates.
- Explain the training-versus-discovery tradeoff before changing crawler
access.
- Prefer a prioritized diagnosis and test plan over an undifferentiated SEO
checklist.
Deliverable
Return the baseline, findings with evidence, prioritized actions, measurement
plan, and the next experiment. If implementation was requested, make only the
approved changes and verify the affected pages or instrumentation.
