Agent skill

marketing-ai-search-optimization

Modern search visibility optimization covering traditional search fundamentals, SERP evolution, and optional assistant/answer-engine visibility with technical setup, content strategies, and measurement frameworks.

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/marketing-ai-search-optimization

SKILL.md

SEARCH VISIBILITY & MODERN DISCOVERY — OPERATIONAL SKILL

This skill contains actionable, production-ready systems for content discoverability across traditional search and modern SERP surfaces. Assistant/answer-engine visibility is covered only in clearly labeled optional sections.

Structure: Core search visibility fundamentals first. AI-specific optimization in clearly labeled "Optional: AI / Automation" sections.


Core: Search Intent Modeling

Every piece of content must map to user intent. Misaligned intent = wasted effort.

Intent Type User Goal Content Format Conversion Likelihood
Informational Learn/understand Guides, tutorials, explainers Low (nurture)
Navigational Find specific brand/page Brand pages, product docs Medium (existing interest)
Commercial Research before buying Comparisons, reviews, vs-pages High
Transactional Buy/sign up now Pricing, checkout, demo pages Highest

Do

  • Map content inventory to intent types
  • Prioritize commercial + transactional for revenue impact
  • Use informational content for top-of-funnel brand building
  • Match page structure to intent (transactional = short; informational = comprehensive)

Avoid

  • Publishing "informational" content expecting direct conversions
  • Mixing multiple intents on one page
  • Ignoring navigational intent (your brand searches matter)

Core: SERP Surface Evolution (2025)

Search results are no longer 10 blue links. Modern SERP surfaces:

SERP Feature Visibility Impact Optimization Priority
Rich Results (eligible types only) High — enhanced display Implement only where supported
Answer Boxes Very high — position zero Concise, direct answers
Knowledge Panels High for entities Entity/brand optimization
People Also Ask Medium-high Question-answer format
Local Pack (if relevant) High Strong location signals + GBP
Video / Image Surfaces Medium-high Media SEO + clear metadata
Zero-Click / On-SERP Answers High Optimize for visibility + intent

Zero-Click Reality

More queries are satisfied on the results page via answer boxes, panels, and rich results. Plan for it:

Strategy Description
Accept Optimize for brand visibility in zero-click (answer boxes, panels)
Adapt Target queries with click-through intent (commercial/transactional)
Measure Track impressions AND clicks, not just rankings

Do

Avoid

  • Measuring SEO success by rankings alone (impressions matter)
  • Ignoring zero-click—it's visibility even without traffic
  • Over-optimizing for features your content can't win

Core: Brand Visibility & Trust Signals

E-E-A-T Framework (Google Quality Raters)

Signal What It Means How to Demonstrate
Experience First-hand knowledge Case studies, original data, personal narrative
Expertise Subject matter depth Author credentials, technical accuracy
Authoritativeness Industry recognition Backlinks, citations, press mentions
Trust Reliability, safety HTTPS, clear contact, accurate info, reviews

Source: Google Search Quality Rater Guidelines (used for human evaluation, not a direct ranking checklist): https://static.googleusercontent.com/media/guidelines.raterhub.com/en//searchqualityevaluatorguidelines.pdf

Do

  • Add author bios with credentials to expertise content
  • Include original research, data, or unique insights
  • Get cited by authoritative sources in your niche
  • Keep information accurate and updated

Avoid

  • Anonymous "admin" authored content for YMYL topics
  • Rehashing competitor content without adding value
  • Neglecting site security and trust signals

Core: Content Discoverability Checklist

Use before publishing any content:

Check Requirement Pass/Fail
Intent mapped Clear primary intent identified
H1 + meta title Include target query, <60 chars
Meta description Clear value prop, <155 chars
URL structure 5-7 words, semantic, no parameters
Internal links 3+ contextual links to/from related pages
Structured data Implement only eligible, accurate types
First paragraph Direct answer to query in first 100 words
Freshness signal Date published/updated visible
Mobile usability Mobile-first layout and QA (see Google guidance on Page Experience and retired Mobile Usability report: https://developers.google.com/search/blog/2023/04/page-experience-in-search)
Performance Core Web Vitals monitored (LCP/INP/CLS: https://web.dev/articles/vitals)

For a comprehensive audit covering both traditional and AI search visibility, use search-visibility-audit.md.


Core: Measurement Framework

What to Track

Track visibility, engagement, and business outcomes together (Search Console metric definitions: https://support.google.com/webmasters/answer/7576553?hl=en).

Metric Where Use It For
Impressions Google Search Console Demand/visibility trends by query/page
Clicks Google Search Console Traffic contribution by query/page
CTR Google Search Console Snippet/title alignment to intent
Average position Google Search Console Directional ranking movement (not a KPI alone)
Landing conversions Analytics/CRM Query/page → lead/signup/purchase rate
Assisted conversions Analytics Content influence across longer journeys
Brand demand Search Console + Trends Branded query growth and protection

What to Ignore (Vanity)

  • Rankings without traffic context
  • Impressions without CTR analysis
  • Backlink counts without quality assessment and relevance
  • Page-level metrics without conversion attribution

Use this skill when the user asks for:

  • Search intent and content mapping
  • SERP feature targeting and snippet optimization
  • Content discoverability audits (technical + editorial)
  • Brand visibility and trust signal improvements (E-E-A-T)
  • Measurement plans (impressions, clicks, CTR, assisted conversions)
  • Optional: visibility in AI answer engines and assistant surfaces

Quick Reference

Task Resource/Template Location When to Use
Search visibility audit Search Visibility Audit Checklist templates/audits/search-visibility-audit.md Baseline and prioritize improvements
Technical SEO audit SEO Technical Audit Checklist ../marketing-seo-technical/templates/audits/full-technical-audit.md Crawl/index/render/performance issues
Content distribution Distribution Plan (Search + Social) ../marketing-social-media/templates/content-distribution-plan.md Ship content with a plan for demand capture
Landing conversion Landing Page Conversion Checklist ../marketing-leads-generation/templates/landing-audit-checklist.md Improve CVR from search traffic
Optional: AI visibility AI Search Content Audit templates/audits/ai-search-content-audit.md Validate assistant/answer engine visibility

Decision Trees (Quick Use)

text
### High impressions, low clicks (GSC)
Intent mismatch → Narrow query target or split page by intent
Snippet mismatch → Rewrite title/snippet to match query language and value
SERP feature loss → Add eligible structured data; improve media; strengthen internal links

### Traffic ok, conversions low
Wrong offer for intent → Add comparison/pricing/use-case path for commercial intent
Friction high → Reduce form fields, speed up page, improve trust signals
Weak proof → Add quantified outcomes, case studies, security/compliance

### Page not indexed / not visible
Blocked → robots.txt / meta robots / auth / soft-404
Duplicate → canonical + internal linking + sitemap hygiene
JS render issues → SSR/SSG for primary content (dynamic rendering is deprecated: https://developers.google.com/search/docs/crawling-indexing/javascript/dynamic-rendering)

### Optional: AI answer engines not mentioning brand
[Inference] Audience uses assistants → Run AI visibility checks + fix discoverability
[Inference] Brand missing → Publish canonical, citable pages; strengthen entity signals

For optional AI/assistant decision trees, see the "Optional: AI / Automation" section.


Navigation

Core Resources

  • templates/audits/search-visibility-audit.md - Baseline audit checklist
  • resources/measurement-analytics.md - Measurement and analytics setup notes
  • ../marketing-seo-technical/SKILL.md - Deep technical SEO playbooks

Optional: AI / Automation Guides

  • resources/platform-chatgpt.md - ChatGPT/SearchGPT optimization
  • resources/platform-perplexity.md - Perplexity ranking strategies
  • resources/platform-claude.md - Claude AI search optimization
  • resources/platform-gemini.md - Google Gemini strategies
  • resources/platform-google-ai-overviews.md - SGE/AIO optimization

Templates

Technical

  • templates/technical/robots-txt-ai-crawlers.md
  • templates/technical/ai-search-schema-templates.md
  • templates/technical/server-side-rendering-guide.md

Content

  • templates/content/ai-search-content-brief.md
  • templates/content/answer-focused-article-template.md
  • templates/content/entity-rich-content-template.md

Audits & Testing

  • templates/audits/search-visibility-audit.md - NEW Full search visibility audit (traditional + AI)
  • templates/audits/ai-search-content-audit.md
  • templates/audits/crawler-access-audit.md
  • templates/testing/ai-search-testing-protocol.md

Tracking

  • templates/tracking/ai-search-analytics-setup.md
  • templates/tracking/citation-tracking-dashboard.md

Related Skills

Marketing & SEO

  • ../marketing-social-media/SKILL.md - Social distribution and community workflows
  • ../product-management/SKILL.md - Product positioning and messaging alignment

Technical Implementation

  • ../software-frontend/SKILL.md - SSR implementation and technical optimization
  • ../software-backend/SKILL.md - API endpoints, caching, and reliability
  • ../ops-devops-platform/SKILL.md - CI/CD, CDN, and infrastructure performance

Data & Analytics

  • ../data-sql-optimization/SKILL.md - Analytics warehousing for search visibility metrics

Optional: AI / Automation

  • ../ai-prompt-engineering/SKILL.md - Content assistance workflows (with human review)
  • ../ai-agents/SKILL.md - Monitoring and reporting automation patterns

Key Differentiators

[Inference] This skill treats modern search as a system: crawl/index/render + intent + SERP surfaces + measurement. Optional AI/assistant optimization is additive, not a replacement.


External Resources

See data/sources.json for 28 primary documentation sources across:

  • Google Search docs (fundamentals, crawling/indexing, appearance)
  • web.dev guidance (Core Web Vitals and performance)
  • Search Console measurement definitions
  • Optional assistant visibility controls (Google-Extended, GPTBot) (tagged optional)

Getting Started

First-time setup (30–60 minutes):

  1. Run templates/audits/search-visibility-audit.md on the top 10–20 pages.
  2. Fix obvious indexability issues (robots/noindex/canonicals/sitemaps) using ../marketing-seo-technical/SKILL.md.
  3. Pick 5–10 queries per ICP segment; map each to a single intent and page.
  4. Add measurement: GSC dashboards + conversion events (define what "conversion" means).

Weekly cadence (60 minutes/week):

  1. Review GSC: high impressions + low CTR queries; ship 5 title/snippet improvements.
  2. Review conversions by landing page; fix the 1–2 worst offenders with the CRO checklist.
  3. Ship 1 new commercial-intent page or update 1 core page for freshness and proof.

Optional: AI / Automation

Note: Use this only if your ICP actually discovers products via assistants/answer engines. Keep SEO fundamentals as the baseline.

What to Do First (AI Visibility)

  1. Run templates/audits/ai-search-content-audit.md on 5–10 key pages.
  2. Validate that key pages are indexable and canonical (assistants often cite canonical URLs first).
  3. Ensure content has citation-grade proof: original data, reproducible steps, and clear definitions.

Crawler Controls (AI Training vs Search)

Do (AI Visibility)

  • Prioritize pages that already drive conversions (not net-new content for an unproven channel).
  • Make claims auditable: add sources, screenshots, definitions, and dates.
  • Keep a single canonical URL per topic; avoid duplicate thin variants.

Avoid (AI Visibility)

  • Treating assistant visibility as a replacement for SEO or product positioning.
  • Publishing "AI-first" pages that weaken intent match and conversion clarity.
  • Over-investing in tools before you can observe any incremental pipeline impact.

Collaboration Notes

With Product

Core

  • Positioning and messaging should inform target queries and page hierarchy.
  • Feature pages need clear claims, proof, and intent-aligned CTAs.
  • Docs and changelogs should be indexable, canonical, and internally linked.

Optional: AI / Automation

  • [Inference] Technical docs are frequently reused in assistant answers; keep them current and link to canonical sources.

With Sales

Core

  • Mine objections and FAQs to create commercial-intent pages (comparisons, security, integrations, pricing).
  • Align on "good lead" definition so content targets the right intent.

Optional: AI / Automation

  • [Inference] Monitor brand/competitor questions in assistants to find missing pages and trust gaps.

With Engineering

Core

  • Implement and version control: robots.txt, canonicals, redirects, sitemaps, and structured data.
  • Maintain performance budgets and monitor Core Web Vitals (https://web.dev/articles/vitals).
  • Ensure analytics events and UTMs survive navigation and cross-domain flows.

Optional: AI / Automation


Anti-Patterns

Core

Anti-Pattern Why It Fails Instead
Reporting rankings only Hides the real outcome Report impressions, clicks, CTR, and conversions (https://support.google.com/webmasters/answer/7576553?hl=en)
Publishing without intent mapping Pages miss the query and the CTA One page, one primary intent, one primary conversion
Gating early-stage pages Kills discovery and trust Gate only high-intent or high-value assets
Schema spam Manual actions risk; no upside Implement accurate, eligible structured data only
Many thin near-duplicates Cannibalization and index bloat Consolidate to canonical pages + strong internal links

Optional: AI / Automation

Anti-Pattern Why It Fails Instead
Publishing "AI-first" pages Weakens intent match and conversion clarity Treat assistant visibility as additive to SEO
Blocking all crawlers "for protection" Can reduce visibility in multiple systems Use explicit controls and rate limiting where needed
Chasing every assistant platform Spreads effort too thin Validate one channel with measurable pipeline impact first

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results