ai-seo

Name: ai-seo
Author: MoizIbnYousaf

27stars5forks

How to install ai-seo?

moizibnyousaf/marketing-cli/ai-seo

$npx -y skills add MoizIbnYousaf/marketing-cli --skill ai-seo

Installs into the current project.

Summary

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

Files · 1

View on GitHub

SKILL.md

1	# AI SEO Optimization
2
3	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.
4
5	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.
6
7	## On Activation
8
9	1. Read `brand/` directory: load `voice-profile.md`, `keyword-plan.md`, `positioning.md`, `competitors.md` if present.
10	2. Show what loaded:
11	```
12	Brand context loaded:
13	├── Voice Profile ✓/✗
14	├── Keyword Plan ✓/✗
15	├── Positioning ✓/✗
16	└── Competitors ✓/✗
17	```
18	3. If no brand files exist, ask: What topics do you want AI engines to cite you for? Who are your competitors in AI results?
19	4. Determine mode: Audit (assess current AI visibility) or Optimize (improve content for AI citation).
20	5. If keyword plan exists, flag which queries are likely AI-dominated (how-to, what-is, comparison queries).
21
22	---
23
24	## How AI Search Works (The Mental Model)
25
26	Traditional search: User types query → Google ranks pages → user clicks a link
27	AI search: User asks question → AI reads sources → AI synthesizes answer → cites sources inline
28
29	What this means for you:
30	- You're not competing for clicks. You're competing to be a cited source.
31	- AI engines favor content that directly, clearly, authoritatively answers questions.
32	- Structure and clarity matter more than keyword density.
33	- Being cited once compounds — AI engines build entity graphs that persist.
34
35	## Playbook Pages = AI-Citation Surface Area
36
37	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:
38
39	\| Why playbooks win citations \| Detail \|
40	\|---\|---\|
41	\| Step-based structure \| `HowTo` schema makes the answer machine-extractable; AI engines lift the steps verbatim \|
42	\| Named author + entity \| Author bio with sameAs links to social profiles compounds the entity graph \|
43	\| Concrete numbers \| Specific stats ("73% of B2B SaaS under 50 employees post less than once a week") get cited; vague claims ("most companies struggle") don't \|
44	\| Counter-arguments inline \| AI engines reward sources that show "thinking" — playbooks with "don't do X because Y" sections demonstrate authority \|
45	\| dateModified discipline \| Recent modification dates signal freshness; AI engines deprecate stale sources \|
46
47	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.
48
49	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.
50
51	---
52
53	## Brand Integration
54
55	- 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.
56	- keyword-plan.md → Target queries where the brand has genuine authority. AI engines cite sources that demonstrate expertise, not just keyword density.
57
58	## Step 1: AI Visibility Audit
59
60	### Check Current AI Presence
61
62	Use available tools to test AI visibility. Not all engines will be testable — audit what you can, note what you can't.
63
64	With browser tool available:
65	1. Perplexity: Navigate to perplexity.ai, search "[your topic]" — check if pages appear in sources
66	2. Google AI Overviews: Search on google.com — check if brand appears in AI Overview
67	3. ChatGPT: Navigate to

People who liked this also viewed

6 picks

Type

ai-seo

27stars5forks

View on GitHub

How to install ai-seo?

moizibnyousaf/marketing-cli/ai-seo

$npx -y skills add MoizIbnYousaf/marketing-cli --skill ai-seo

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# AI SEO Optimization
2
3	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.
4
5	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.
6
7	## On Activation
8
9	1. Read `brand/` directory: load `voice-profile.md`, `keyword-plan.md`, `positioning.md`, `competitors.md` if present.
10	2. Show what loaded:
11	```
12	Brand context loaded:
13	├── Voice Profile ✓/✗
14	├── Keyword Plan ✓/✗
15	├── Positioning ✓/✗
16	└── Competitors ✓/✗
17	```
18	3. If no brand files exist, ask: What topics do you want AI engines to cite you for? Who are your competitors in AI results?
19	4. Determine mode: Audit (assess current AI visibility) or Optimize (improve content for AI citation).
20	5. If keyword plan exists, flag which queries are likely AI-dominated (how-to, what-is, comparison queries).
21
22	---
23
24	## How AI Search Works (The Mental Model)
25
26	Traditional search: User types query → Google ranks pages → user clicks a link
27	AI search: User asks question → AI reads sources → AI synthesizes answer → cites sources inline
28
29	What this means for you:
30	- You're not competing for clicks. You're competing to be a cited source.
31	- AI engines favor content that directly, clearly, authoritatively answers questions.
32	- Structure and clarity matter more than keyword density.
33	- Being cited once compounds — AI engines build entity graphs that persist.
34
35	## Playbook Pages = AI-Citation Surface Area
36
37	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:
38
39	\| Why playbooks win citations \| Detail \|
40	\|---\|---\|
41	\| Step-based structure \| `HowTo` schema makes the answer machine-extractable; AI engines lift the steps verbatim \|
42	\| Named author + entity \| Author bio with sameAs links to social profiles compounds the entity graph \|
43	\| Concrete numbers \| Specific stats ("73% of B2B SaaS under 50 employees post less than once a week") get cited; vague claims ("most companies struggle") don't \|
44	\| Counter-arguments inline \| AI engines reward sources that show "thinking" — playbooks with "don't do X because Y" sections demonstrate authority \|
45	\| dateModified discipline \| Recent modification dates signal freshness; AI engines deprecate stale sources \|
46
47	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.
48
49	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.
50
51	---
52
53	## Brand Integration
54
55	- 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.
56	- keyword-plan.md → Target queries where the brand has genuine authority. AI engines cite sources that demonstrate expertise, not just keyword density.
57
58	## Step 1: AI Visibility Audit
59
60	### Check Current AI Presence
61
62	Use available tools to test AI visibility. Not all engines will be testable — audit what you can, note what you can't.
63
64	With browser tool available:
65	1. Perplexity: Navigate to perplexity.ai, search "[your topic]" — check if pages appear in sources
66	2. Google AI Overviews: Search on google.com — check if brand appears in AI Overview
67	3. ChatGPT: Navigate to

People who liked this also viewed

6 picks

Type