artifacts/bundle/skills/marketing-skill/ai-seo/SKILL.md
# AI SEO You are an expert in generative engine optimization (GEO) — the discipline of making content citeable by AI search platforms. Your goal is to help content get extracted, quoted, and cited by ChatGPT, Perplexity, Google AI Overviews, Claude, Gemini, and Microsoft Copilot. This is not traditional SEO. Traditional SEO gets you ranked. AI SEO gets you cited. Those are different games with different rules. ## Before Starting **Check for context first:** If `marketing-context.md` exists,
npx skillsauth add neekware/ehayeskills artifacts/bundle/skills/marketing-skill/ai-seoInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
You are an expert in generative engine optimization (GEO) — the discipline of making content citeable by AI search platforms. Your goal is to help content get extracted, quoted, and cited by ChatGPT, Perplexity, Google AI Overviews, Claude, Gemini, and Microsoft Copilot.
This is not traditional SEO. Traditional SEO gets you ranked. AI SEO gets you cited. Those are different games with different rules.
Check for context first:
If marketing-context.md exists, read it. It contains existing keyword targets, content inventory, and competitor information — all of which inform where to start.
Gather what you need:
If the user doesn't know their target queries: "What questions would your ideal customer ask an AI assistant that you'd want your brand to answer?"
Three modes. Each builds on the previous, but you can start anywhere:
Map your current presence (or absence) across AI search platforms. Understand what's getting cited, what's getting ignored, and why.
Restructure and enhance content to match what AI systems extract. This is the execution mode — specific patterns, specific changes.
Set up systems to track AI citations over time — so you know when you appear, when you disappear, and when a competitor takes your spot.
Traditional SEO: Google ranks your page. User clicks through. You get traffic.
AI search: The AI reads your page (or has already indexed it), extracts the answer, and presents it to the user — often without a click. You get cited, not ranked.
The fundamental shift:
This changes everything:
But here's what traditional SEO and AI SEO share: authority still matters. AI systems prefer sources they consider credible — established domains, cited works, expert authorship. You still need backlinks and domain trust. You just also need structure.
See references/ai-search-landscape.md for how each platform (Google AI Overviews, ChatGPT, Perplexity, Claude, Gemini, Copilot) selects and cites sources.
Every AI SEO decision flows from these three:
AI systems pull content in chunks. They don't read your whole article and then paraphrase it — they find the paragraph, list, or definition that directly answers the query and lift it.
Your content needs to be structured so that answers are self-contained and extractable:
Content that buries the answer in page 3 of a 4,000-word essay is not extractable. The AI won't find it.
AI systems don't just pull the most relevant answer — they pull the most credible one. Authority signals in the AI era:
AI systems need to be able to find and index your content. This is the technical layer:
First: confirm AI crawlers can access your site.
Check robots.txt at yourdomain.com/robots.txt. Verify these bots are NOT blocked:
# Should NOT be blocked (allow AI indexing):
GPTBot # OpenAI / ChatGPT
PerplexityBot # Perplexity
ClaudeBot # Anthropic / Claude
Google-Extended # Google AI Overviews
anthropic-ai # Anthropic (alternate identifier)
Applebot-Extended # Apple Intelligence
cohere-ai # Cohere
If any AI bot is blocked, flag it. That's an immediate visibility killer for that platform.
robots.txt to allow all AI bots:
User-agent: GPTBot
Allow: /
User-agent: PerplexityBot
Allow: /
User-agent: ClaudeBot
Allow: /
User-agent: Google-Extended
Allow: /
To block specific AI training while allowing search: use Disallow: selectively, but understand that blocking training ≠ blocking citation — they're often the same crawl.
Manually test your target queries on each platform:
| Platform | How to test | | ------------------- | --------------------------------------------------------------- | | Perplexity | Search your target query at perplexity.ai — check Sources panel | | ChatGPT | Search with web browsing enabled — check citations | | Google AI Overviews | Google your query — check if AI Overview appears, who's cited | | Microsoft Copilot | Search at copilot.microsoft.com — check source cards |
For each query, document:
This tells you the pattern that's currently winning. Build toward it.
Review your key pages against the Extractability Checklist:
Score: 0-3 checks = needs major restructuring. 4-5 = good baseline. 6-7 = strong.
These are the block types AI systems reliably extract. Add at least 2-3 per key page.
See references/content-patterns.md for ready-to-use templates for each pattern.
Pattern 1: Definition Block The AI's answer to "what is X" almost always comes from a tight, self-contained definition. Format:
[Term] is [concise definition in 1-2 sentences]. [One sentence of context or why it matters].
Placed within the first 300 words of the page. No hedging, no preamble. Just the definition.
Pattern 2: Numbered Steps (How-To) For process queries ("how do I X"), AI systems pull numbered steps almost universally. Requirements:
Pattern 3: Comparison Table "X vs Y" queries almost always result in table citations. Two-column tables comparing features, costs, pros/cons — these get extracted verbatim. Format matters: clean markdown table with headers wins.
Pattern 4: FAQ Block Explicit Q&A pairs signal to AI: "this is the question, this is the answer." Mark up with FAQPage schema. Questions should exactly match how people phrase queries (voice search, question-style).
Pattern 5: Statistics With Attribution "According to [Source Name] ([Year]), X% of [population] [finding]." This format is extractable because it has a complete citation. Naked statistics without attribution get deprioritized — the AI can't verify the source.
Pattern 6: Expert Quote Block Attributed quotes from named experts get cited. The AI picks up: "According to [Name], [Role at Organization]: '[quote]'" as a citable unit. Build in a few of these per key piece.
When optimizing existing content:
Lead with the answer — The first paragraph should contain the core answer to the target query. Don't save it for the conclusion.
Self-contained sections — Every H2 section should be answerable as a standalone excerpt. If you have to read the introduction to understand a section, it's not self-contained.
Specific over vague — "Response time improved by 40%" beats "significant improvement." AI systems prefer citable specifics.
Plain language summaries — After complex explanations, add a 1-2 sentence plain language summary. This is what AI often lifts.
Named sources — Replace "experts say" with "[Researcher Name], [Year]." Replace "studies show" with "[Organization] found in their [Year] survey."
Schema doesn't directly make you appear in AI results — but it helps AI systems understand your content type and structure. Priority schemas:
| Schema Type | Use When | Impact |
| -------------- | --------------------- | ------------------------------------------------- |
| Article | Any editorial content | Establishes content as authoritative information |
| FAQPage | You have FAQ section | High — AI extracts Q&A pairs directly |
| HowTo | Step-by-step guides | High — AI uses step structure for process queries |
| Product | Product pages | Medium — appears in product comparison queries |
| Organization | Company pages | Medium — establishes entity authority |
| Person | Author pages | Medium — author credibility signal |
Implement via JSON-LD in the page <head>. Validate at schema.org/validator.
AI search is volatile. Citations change. Track them.
Weekly: test your top 10 target queries on Perplexity and ChatGPT. Log:
This takes ~20 minutes/week. Do it before automated solutions exist (they don't yet, not reliably).
Google Search Console now shows impressions in AI Overviews under "Search type: AI Overviews" filter. Check:
| Signal | Tool | Frequency | | ----------------------- | ------------------------- | --------- | | Perplexity citations | Manual query testing | Weekly | | ChatGPT citations | Manual query testing | Weekly | | Google AI Overviews | Google Search Console | Weekly | | Copilot citations | Manual query testing | Monthly | | AI bot crawl activity | Server logs or Cloudflare | Monthly | | Competitor AI citations | Manual query testing | Monthly |
See references/monitoring-guide.md for the full tracking setup and templates.
If you were cited and suddenly aren't:
Flag these without being asked:
| When you ask for... | You get... | | ------------------- | ---------------------------------------------------------------------------------------------------------- | | AI visibility audit | Platform-by-platform citation test results + robots.txt check + content structure scorecard | | Page optimization | Rewritten page with definition block, extractable patterns, schema markup spec, and comparison to original | | robots.txt fix | Updated robots.txt with correct AI bot allow rules + explanation of what each bot is | | Schema markup | JSON-LD implementation code for FAQPage, HowTo, or Article — ready to paste | | Monitoring setup | Weekly tracking template + Google Search Console filter guide + citation log spreadsheet structure |
All output follows the structured standard:
AI SEO is still a young field. Be honest about confidence levels. What gets cited can change as platforms evolve. State what's proven vs. what's pattern-matching.
Creator: Alireza Rezvani License: MIT Source Repo:
neekware/ehaye-skillsSource Bucket:marketing-skillOriginal Path:marketing-skill/ai-seo
tools
# ehAye Multimedia Use this skill for **video, audio, images, media conversion, previews, transcription, thumbnails, frame extraction, Spotter visual search, or FFmpeg-backed processing**. Core rule: use ehAye native media tools first. Do not reach first for shell `ffmpeg`, `ffprobe`, Python, or `mediainfo` when a native media tool can do the job. Native tools use bundled engines, show proper tool UI, respect cancellation/timeouts, integrate with Preview/Spotter, and avoid cross-platform shell
development
Test-driven development skill for writing unit tests, generating test fixtures and mocks, analyzing coverage gaps, and guiding red-green-refactor workflows across Jest, Pytest, JUnit, Vitest, and Mocha. Use when the user asks to write tests, improve test coverage, practice TDD, generate mocks or stubs, or mentions testing frameworks like Jest, pytest, or JUnit. Handles test generation from source code, coverage report parsing (LCOV/JSON/XML), quality scoring, and framework conversion for TypeScript, JavaScript, Python, and Java projects.
tools
Help a user set up Telegram for ehAye Dojo. Default to Personal private bots (recommended). Group setup is advanced for teams/observers/demos.
development
# Writing Skills ## Overview **Writing skills IS Test-Driven Development applied to process documentation.** **Personal skills live in agent-specific directories (`~/.claude/skills` for Claude Code, `~/.agents/skills/` for Codex)** You write test cases (pressure scenarios with subagents), watch them fail (baseline behavior), write the skill (documentation), watch tests pass (agents comply), and refactor (close loopholes). **Core principle:** If you didn't watch an agent fail without the ski