Source profileQuality 87/100

MoizIbnYousaf/marketing-cli/skills/ai-seo/SKILL.md

ai-seo

Optimize content for AI search engines — ChatGPT, Perplexity, Claude, Gemini, and AI Overviews. Covers entity optimization, structured data, citation-worthy formatting, and platform-specific strategies. Use when someone wants visibility in AI-generated answers, says 'AI SEO', 'AI search', 'LLM optimization', 'ChatGPT ranking', 'Perplexity citations', 'AI Overviews', or wants their content cited by AI assistants. The new SEO frontier — if you're only optimizing for Google, you're already behind.

Source repository stars
27
Declared platforms
0
Static risk flags
2
Last source update
2026-07-28
Source checked
2026-07-28

Decision brief

What it does—and where it fits

You optimize content so AI search engines — ChatGPT, Perplexity, Claude, Gemini, and Google AI Overviews — cite, reference, and recommend it. Traditional SEO gets you on page one of Google. AI SEO gets you into the AI's answer.

Best for

  • Use when someone wants visibility in AI-generated answers, says 'AI SEO', 'AI search', 'LLM optimization', 'ChatGPT ranking', 'Perplexity citations', 'AI Overviews', or wants their content cited by AI assistants.

Not for

  • Traditional SEO is the foundation AI SEO sits on. AI engines pull from web indexes — if your pages aren't ranking or indexed, they can't be cited. Check traditional SEO basics (/seo-audit) before investing in AI-specifi…
  • FAQ schema only works when it matches real Q&A content. Google penalizes schema that doesn't reflect what's visible on the page. Add FAQPage markup to pages with genuine questions and answers, not as a blanket optimizat…

Compatibility matrix

Platform support, with evidence labels

PlatformStatusEvidenceWhat to check
CodexNot declaredNo explicit evidencePortability before use
Claude CodeNot declaredNo explicit evidencePortability before use
CursorNot declaredNo explicit evidencePortability before use
Gemini CLINot declaredNo explicit evidencePortability before use
Open the compatibility checker

Installation

Inspect first. Install second.

The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.

Source-detected install commandSource
npx skills add https://github.com/MoizIbnYousaf/marketing-cli --skill "skills/ai-seo"
Safe inspection promptEditorial

Inspect the Agent Skill "ai-seo" from https://github.com/MoizIbnYousaf/marketing-cli/blob/f12fbcbe4929584697b309b9096c9427b0cfce8e/skills/ai-seo/SKILL.md at commit f12fbcbe4929584697b309b9096c9427b0cfce8e. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.

Workflow

What the source asks the agent to do

  1. 01

    Step 1: AI Visibility Audit

    Use available tools to test AI visibility. Not all engines will be testable — audit what you can, note what you can't.

    Perplexity: Navigate to perplexity.ai, search "[your topic]" — check if pages appear in sourcesGoogle AI Overviews: Search on google.com — check if brand appears in AI OverviewChatGPT: Navigate to chatgpt.com, ask "[your core question]" — check citations
  2. 02

    Step 2: Entity Optimization

    AI engines understand entities (people, brands, products, concepts), not just keywords. You need to establish your entity clearly.

    Wikipedia / Wikidata: If eligible, create or update your entryCrunchbase: Company profile with accurate dataLinkedIn: Complete company and founder profiles
  3. 03

    Step 3: Content Optimization for AI Citation

    AI engines prefer content structured as clear, authoritative answers. For every target query:

    AI engines prefer content structured as clear, authoritative answers. For every target query:
  4. 04

    Step 4: Structured Data for AI

    Every page should have at minimum: - Organization schema (site-wide) - Article + Person schema (all content pages) - FAQPage schema (any page with Q&A content) - BreadcrumbList schema (all pages)

    Organization schema (site-wide)Article + Person schema (all content pages)FAQPage schema (any page with Q&A content)
  5. 05

    Implementation

    Every page should have at minimum: - Organization schema (site-wide) - Article + Person schema (all content pages) - FAQPage schema (any page with Q&A content) - BreadcrumbList schema (all pages)

    Organization schema (site-wide)Article + Person schema (all content pages)FAQPage schema (any page with Q&A content)

Permission review

Static risk signals and limitations

Reads files

low · line 9

The documentation asks the agent to read local files, directories, or repositories.

Read `brand/` directory: load `voice-profile.md`, `keyword-plan.md`, `positioning.md`, `competitors.md` if present.

Network access

medium · line 75

The documentation includes network, browsing, or remote request actions.

Search for "[brand] + [topic]" to assess web presence that AI engines index

Evidence record

Why each signal appears

EvidenceSourceComputedTestedEditorial
SignalValueEvidence typeMeaning
Quality score87/100ComputedDocumentation, specificity, maintenance, and trust rules
Repository stars27SourceRepository attention, not individual Skill quality
Compatibility0 platformsSourceDeclared in the catalog source record
Usage guideautomated source guideEditorialGenerated or reviewed according to the visible evidence level

Pinned source

Provenance and original SKILL.md

Repository
MoizIbnYousaf/marketing-cli
Skill path
skills/ai-seo/SKILL.md
Commit
f12fbcbe4929584697b309b9096c9427b0cfce8e
License
MIT
Collected
2026-07-28
Default branch
main
View the original SKILL.md

AI SEO Optimization

You optimize content so AI search engines — ChatGPT, Perplexity, Claude, Gemini, and Google AI Overviews — cite, reference, and recommend it. Traditional SEO gets you on page one of Google. AI SEO gets you into the AI's answer.

This is a different game. AI engines don't rank pages — they synthesize answers from sources they trust. Your job is to become a source they trust and cite.

On Activation

  1. Read brand/ directory: load voice-profile.md, keyword-plan.md, positioning.md, competitors.md if present.
  2. Show what loaded:

Backend Selection

Prefer OpenSEO get_ranked_keywords / get_serp_results (and AI-search MCP tools when exposed) when configured; otherwise crawl/Exa with ranking data unknown. Full contract: skills/openseo/references/backend-contract.md.

Brand context loaded:
├── Voice Profile   ✓/✗
├── Keyword Plan    ✓/✗
├── Positioning     ✓/✗
└── Competitors     ✓/✗
  1. If no brand files exist, ask: What topics do you want AI engines to cite you for? Who are your competitors in AI results?
  2. Determine mode: Audit (assess current AI visibility) or Optimize (improve content for AI citation).
  3. If keyword plan exists, flag which queries are likely AI-dominated (how-to, what-is, comparison queries).

How AI Search Works (The Mental Model)

Traditional search: User types query → Google ranks pages → user clicks a link AI search: User asks question → AI reads sources → AI synthesizes answer → cites sources inline

What this means for you:

  • You're not competing for clicks. You're competing to be a cited source.
  • AI engines favor content that directly, clearly, authoritatively answers questions.
  • Structure and clarity matter more than keyword density.
  • Being cited once compounds — AI engines build entity graphs that persist.

Playbook Pages = AI-Citation Surface Area

The single highest-leverage page format for AI-citation is the long-form playbook — 2,500+ word pillar content with Article + HowTo JSON-LD, named author, dateModified, and step-based structure. AI engines (ChatGPT search, Perplexity, Claude, Gemini, Google AI Overviews) preferentially cite playbook-pattern pages over short blog posts because:

Why playbooks win citationsDetail
Step-based structureHowTo schema makes the answer machine-extractable; AI engines lift the steps verbatim
Named author + entityAuthor bio with sameAs links to social profiles compounds the entity graph
Concrete numbersSpecific stats ("73% of B2B SaaS under 50 employees post less than once a week") get cited; vague claims ("most companies struggle") don't
Counter-arguments inlineAI engines reward sources that show "thinking" — playbooks with "don't do X because Y" sections demonstrate authority
dateModified disciplineRecent modification dates signal freshness; AI engines deprecate stale sources

Tie-in with seo-machine: if you're running a programmatic sprint, ship playbook pages as Phase 4+ (after alternatives/compare/use-case ship first for conversion). seo-machine Pattern E is the playbook pipeline — pair it with this skill's entity-optimization and FAQ-formatting recipes to maximize citation surface area.

Avoid for AI-citation: generic blog posts with no schema, content without a named author, listicles without a clear "do this not that" stance, pages that hedge every claim with "it depends." These rank but don't get cited.


Brand Integration

  • voice-profile.md → Author entity recognition in AI engines depends on consistent voice across all content. AI engines build brand models from repeated patterns — voice consistency IS an SEO signal.
  • keyword-plan.md → Target queries where the brand has genuine authority. AI engines cite sources that demonstrate expertise, not just keyword density.

Step 1: AI Visibility Audit

Check Current AI Presence

Use available tools to test AI visibility. Not all engines will be testable — audit what you can, note what you can't.

With browser tool available:

  1. Perplexity: Navigate to perplexity.ai, search "[your topic]" — check if pages appear in sources
  2. Google AI Overviews: Search on google.com — check if brand appears in AI Overview
  3. ChatGPT: Navigate to chatgpt.com, ask "[your core question]" — check citations

With web search/Exa MCP only:

  1. Search for "[brand] + [topic]" to assess web presence that AI engines index
  2. Check if key pages appear in top results (AI engines favor high-ranking pages)
  3. Search for competitor content on the same topics to benchmark

Without browser or web search:

  1. Review existing content structure against AI citation patterns (see references/content-patterns.md)
  2. Check schema markup on existing pages
  3. Audit content formatting for extractability
  4. Note limitation: "Live AI visibility testing requires browser access. This audit covers content optimization only."

Audit Output

QueryChatGPTPerplexityAI OverviewClaudeStatus
[query 1]Not citedSource #3Not includedMentionedPartial
[query 2]RecommendedSource #1FeaturedNamedStrong
[query 3]Not mentionedNot foundNot includedNot mentionedAbsent

For each "Absent" or "Partial" query, create an optimization plan.


Step 2: Entity Optimization

AI engines understand entities (people, brands, products, concepts), not just keywords. You need to establish your entity clearly.

Build Your Entity Profile

Ensure these exist and are consistent across the web:

  • Wikipedia / Wikidata: If eligible, create or update your entry
  • Crunchbase: Company profile with accurate data
  • LinkedIn: Complete company and founder profiles
  • Schema.org markup: Organization, Person, Product schemas on your site
  • About page: Clear, factual, third-person description of who you are and what you do
  • Author pages: Every content creator has a page with credentials, links, and bio

Entity Signals to Strengthen

SignalAction
Consistent namingUse the exact same brand name everywhere — no variations
Co-occurrenceGet mentioned alongside known entities in your space
Structured dataOrganization + Person + Product schema on every relevant page
Backlinks from authoritiesCitations from sites AI engines already trust
Cross-platform presenceSame entity info on LinkedIn, Twitter, GitHub, Crunchbase

Step 3: Content Optimization for AI Citation

The Definitive Answer Pattern

AI engines prefer content structured as clear, authoritative answers. For every target query:

## [Question as H2]

[Direct answer in 1-2 sentences — this is what gets cited]

[Supporting detail, evidence, examples in 2-4 paragraphs]

[Data or specific numbers that add credibility]

This pattern works because:

  • AI engines can extract the direct answer for synthesis
  • The supporting detail gives the AI confidence in your authority
  • Specific data makes your content more citable than vague competitors

Question-Answer Formatting

Structure content to match how people ask AI engines questions:

Identify conversational queries:

  • "What is the best [X] for [Y]?"
  • "How do I [accomplish Z]?"
  • "What's the difference between [A] and [B]?"
  • "[X] vs [Y] — which should I choose?"
  • "Why does [thing] happen?"

For each query, create a section that:

  1. Uses the question (or close variant) as the heading
  2. Answers directly in the first sentence
  3. Provides supporting evidence
  4. Includes specific numbers, dates, or examples
  5. Links to primary sources when citing claims

FAQ Sections

Add FAQ sections with structured data to every key page:

## Frequently Asked Questions

### [Exact question someone would ask an AI]
[Direct, authoritative answer. 2-4 sentences. Include a specific fact or number.]

### [Next question]
[Direct answer.]

Add FAQPage schema markup to every FAQ section.


Step 4: Structured Data for AI

Required Schema Types

SchemaPurposeAI Engine Benefit
OrganizationEstablish entityAll engines — entity recognition
Person (authors)Author authorityPerplexity, Google AI — source credibility
ArticleContent metadataAll engines — content classification
FAQPageQ&A contentGoogle AI Overviews — direct extraction
HowToProcess contentGoogle AI Overviews — step extraction
ProductProduct infoChatGPT, Perplexity — recommendation queries
ReviewCredibility signalAll engines — trust signal

Implementation

Every page should have at minimum:

  • Organization schema (site-wide)
  • Article + Person schema (all content pages)
  • FAQPage schema (any page with Q&A content)
  • BreadcrumbList schema (all pages)

Step 5: Citation-Friendly Formatting

AI engines are more likely to cite content that is easy to parse and extract from.

Formatting Rules

  1. Clear hierarchy: H1 → H2 → H3, logical flow, no skipped levels
  2. Short paragraphs: 2-3 sentences max, one idea per paragraph
  3. Definition patterns: "X is [clear definition]." — direct, extractable
  4. Comparison tables: AI engines love structured comparisons
  5. Numbered lists: Steps, rankings, processes — easy to extract
  6. Data presentation: Tables > prose for statistics and comparisons
  7. Primary source citations: Link to studies, reports, official docs
  8. Last updated dates: Show freshness — AI engines prefer recent content

What AI Engines Trust

Trust SignalHow to Implement
Author expertiseAuthor page with credentials, experience, publications
Original researchProprietary data, surveys, case studies
External citationsCite reputable sources, link to primary research
FreshnessRegular updates, current year stats, "last updated" dates
DepthComprehensive coverage that other sources lack
SpecificityExact numbers, dates, examples over vague claims
ConsistencySame facts across your site, no contradictions

Step 6: Platform-Specific Strategies

Perplexity

  • Perplexity heavily indexes web content and favors clear, structured pages
  • Strong source attribution — your URL appears next to cited text
  • Optimize for question-based queries with direct answers
  • Technical content and comparisons perform well

ChatGPT (with browsing)

  • Browses the web for current information
  • Favors authoritative, well-structured content
  • Brand mentions in trusted sources increase recommendation likelihood
  • Product/comparison pages get cited for "best X" queries

Google AI Overviews

  • Pulls from existing Google index — traditional SEO still matters
  • Favors content that directly answers the query in 2-3 sentences
  • FAQ schema content frequently appears in AI Overviews
  • How-to and listicle formats are heavily extracted

Claude

  • Knowledge is training-based (less real-time web access)
  • Entity recognition from web-scale training data
  • Being mentioned across many trusted sources increases recognition
  • Wikipedia, major publications, and authoritative sites have outsized impact

Step 7: Monitoring and Iteration

Monthly AI Visibility Check

  1. Re-run the audit queries across all AI engines
  2. Track changes in citation status
  3. Identify new queries where AI engines are active in your space
  4. Update content that lost AI visibility
  5. Create new content for queries where you're absent

Tracking Sheet

| Month | Query | Engine | Status | Action Taken | Result |
|-------|-------|--------|--------|-------------|--------|
| Mar 2026 | "best X for Y" | Perplexity | Source #5 | Added comparison table | TBD |
| Mar 2026 | "how to Z" | ChatGPT | Not cited | Created definitive answer | TBD |

Key Differences from Traditional SEO

Traditional SEOAI SEO
Optimize for keywordsOptimize for questions and entities
Compete for page 1 rankingCompete to be a cited source
Keyword density mattersAnswer clarity matters
Backlinks drive authorityBeing mentioned across trusted sources drives authority
Meta tags for CTRStructured data for extraction
Content length signals depthAnswer directness signals usefulness
One-time optimizationContinuous monitoring across multiple engines

Anti-Patterns

  • Traditional SEO is the foundation AI SEO sits on. AI engines pull from web indexes — if your pages aren't ranking or indexed, they can't be cited. Check traditional SEO basics (/seo-audit) before investing in AI-specific optimization.
  • FAQ schema only works when it matches real Q&A content. Google penalizes schema that doesn't reflect what's visible on the page. Add FAQPage markup to pages with genuine questions and answers, not as a blanket optimization.
  • AI citation is volatile — a single test proves nothing. A page cited this week may drop next month as AI models update their indexes and weights. The monitoring step (Step 7) exists because ongoing tracking is the only way to maintain AI visibility.
  • Write for humans, format for AI. Over-optimizing for extractability (robotic, formulaic answers) hurts traditional SEO and user trust. The best AI-cited content is genuinely useful content that happens to be well-structured.
  • Robots.txt is the gatekeeper. If AI bots (GPTBot, PerplexityBot, ClaudeBot) are blocked, no amount of content optimization matters. This is the very first thing to check — see references/platform-ranking-factors.md for the full bot list.

Error States

  • No web search or browser available: Skip live audit (Step 1), proceed with content optimization (Steps 2-6) using existing content analysis. Note: "AI visibility audit requires browser or web search. Content optimization complete — recommend live audit when tools are available."
  • No brand files exist: Ask for target topics and competitors directly. Proceed with generic optimization. Suggest running /brand-voice and /keyword-research first.
  • No existing content to optimize: Shift to content planning mode — create the ai-seo-content-plan.md with priority queries and content specs. Suggest /seo-content to create the actual content.
  • Can't access AI engines for testing: Focus on content structure, schema markup, and formatting optimization. Flag that live testing is deferred.

File Output Format

Directory

marketing/seo/
├── ai-seo-audit.md          # AI visibility audit results
├── ai-seo-content-plan.md   # Priority queries + optimization plan
└── ai-seo-tracking.md       # Monthly tracking sheet

Frontmatter (ai-seo-audit.md)

---
title: "AI SEO Visibility Audit"
date_created: "{YYYY-MM-DD}"
last_updated: "{YYYY-MM-DD}"
queries_tested: {number}
engines_tested: ["Perplexity", "ChatGPT", "Google AI Overviews"]
overall_status: "strong / partial / absent"
priority_actions: {number}
---

Frontmatter (ai-seo-content-plan.md)

---
title: "AI SEO Content Optimization Plan"
date_created: "{YYYY-MM-DD}"
priority_queries: {number}
content_to_create: {number}
content_to_optimize: {number}
---

Chain Offers

After completing, suggest:

  • /seo-audit — ensure traditional SEO foundations support AI visibility
  • /seo-content — create new content optimized for AI citation
  • /brand-voice — consistent authoritative voice increases citation likelihood
  • /keyword-research — identify which queries are AI-dominated in your space
  • "Monthly recheck" — re-run the audit to track AI visibility changes

Related Skills

  • seo-audit: Traditional SEO foundation that supports AI SEO
  • seo-content: Content creation with AI-friendly formatting
  • keyword-research: Identify which queries are AI-dominated
  • brand-voice: Authoritative voice increases citation likelihood

Alternatives

Compare before choosing

Computed 8342,015

coreyhaines31/marketingskills

ai-seo

When the user wants to optimize content for AI search engines, get cited by LLMs, or appear in AI-generated answers. Also use when the user mentions 'AI SEO,' 'AEO,' 'GEO,' 'LLMO,' 'answer engine optimization,' 'generative engine optimization,' 'LLM optimization,' 'AI Overviews,' 'optimize for ChatGPT,' 'optimize for Perplexity,' 'AI citations,' 'AI visibility,' 'zero-click search,' 'how do I show up in AI answers,' 'LLM mentions,' 'optimize for Claude/Gemini,' 'llms.txt,' 'OKF,' 'Open Knowledge

Computed 9427

MoizIbnYousaf/marketing-cli

seo-audit

When the user wants to audit, review, or diagnose SEO issues, plan site architecture, or implement schema markup. Use when someone says 'SEO audit', 'technical SEO', 'site architecture', 'schema markup', 'internal linking', 'why isn't my site ranking', 'site health check', 'crawl issues', 'fix my SEO', 'my traffic dropped', 'rankings fell', or 'site not ranking'. Also trigger when someone wants to plan URL structure, design navigation, add structured data, or review any website for search perfor

Computed 9342,015

coreyhaines31/marketingskills

attribution

When the user wants to figure out which marketing actually drives conversions and revenue, choose or interpret an attribution model, or reconcile conflicting numbers across tools. Also use when the user mentions "attribution," "attribution model," "first-touch vs last-touch," "multi-touch," "which channel drives revenue," "what's my real CAC," "my dashboards disagree," "Google/Meta says X but GA says Y," "media mix model," "MMM," "incrementality," "geo lift," "holdout test," "how did you hear ab

Computed 9342,015

coreyhaines31/marketingskills

directory-submissions

When the user wants to submit their product to startup, SaaS, AI, agent, MCP, no-code, or review directories for backlinks, domain rating, and discovery. Also use when the user mentions "directory submissions," "submit to directories," "backlinks from directories," "list my product," "submit to Product Hunt," "BetaList," "TAAFT," "Futurepedia," "G2 listing," "Capterra listing," "AlternativeTo," "SaaSHub," "AI directories," "MCP registry," "agent directory," "dofollow backlinks," "launch director