🔍 SEO & GEO Optimizer

The only AI skill that covers Google · Bing · AI Overviews · Bing Copilot · ChatGPT · Perplexity — in one file, for every AI IDE.

What this is

A single .md skill file you drop into your AI IDE. Once active, your AI becomes a senior SEO + GEO strategist that:

• Asks you 40 targeted intake questions before touching anything
• Analyzes 3–5 real SEO competitors across Google and Bing
• Builds a full Execution Plan Report and waits for your written approval
• Executes across 10 phases — stopping after each one to report and confirm
• Covers both traditional SEO and Generative Engine Optimization (GEO) for AI search

The AI never makes a change without your explicit approval. Ever.

Install in one command

Open your terminal inside your project folder and run:

npx seo-geo-optimizer

That's it. The installer auto-detects your IDE and places the skill in the right directory.

Or copy-paste manually — no terminal needed

Choose your IDE below and follow the 2-step instructions.

📄 The raw skill file: skill/SEO_GEO_SKILL.md — this is what you're installing.

Cursor

Step 1 — Create the file .cursor/rules/seo-geo-optimizer.mdc in your project root.

Step 2 — Paste the full contents of skill/SEO_GEO_SKILL.md into it.

# Or via terminal
mkdir -p .cursor/rules
curl -o .cursor/rules/seo-geo-optimizer.mdc \
  https://raw.githubusercontent.com/Aryanpanwar10005/seo-geo-optimizer/main/skill/SEO_GEO_SKILL.md

The skill activates automatically in all Cursor AI and Composer sessions.

Windsurf

Step 1 — Create the file .windsurf/rules/seo-geo-optimizer.md in your project root.

Step 2 — Paste the full contents of skill/SEO_GEO_SKILL.md into it.

# Or via terminal
mkdir -p .windsurf/rules
curl -o .windsurf/rules/seo-geo-optimizer.md \
  https://raw.githubusercontent.com/Aryanpanwar10005/seo-geo-optimizer/main/skill/SEO_GEO_SKILL.md

The skill activates automatically in all Cascade AI sessions.

GitHub Copilot (VS Code)

Step 1 — Create the file .github/copilot-instructions.md in your project root.

Step 2 — Paste the full contents of skill/SEO_GEO_SKILL.md into it.

# Or via terminal
mkdir -p .github
curl -o .github/copilot-instructions.md \
  https://raw.githubusercontent.com/Aryanpanwar10005/seo-geo-optimizer/main/skill/SEO_GEO_SKILL.md

The skill activates automatically in all Copilot Chat sessions inside VS Code.

Replit

Replit does not use rule files. Use this method:

Step 1 — Open your Replit project.

Step 2 — Click the AI assistant icon → open System Prompt or Custom Instructions.

Step 3 — Paste the full contents of skill/SEO_GEO_SKILL.md into the field.

Step 4 — Save and start a new conversation.

Tip: You can also keep the raw file URL open in a browser tab and paste it fresh each session if Replit doesn't persist your system prompt between projects.

Lovable

Step 1 — Open your Lovable project settings.

Step 2 — Navigate to Custom Instructions or System Prompt.

Step 3 — Paste the full contents of skill/SEO_GEO_SKILL.md.

Alternatively, the installer creates .ai/seo-geo-optimizer.md if you run npx seo-geo-optimizer --lovable.

Bolt

Step 1 — Open your Bolt project.

Step 2 — Go to Project Settings → AI Instructions or the prompt configuration panel.

Step 3 — Paste the full contents of skill/SEO_GEO_SKILL.md.

Alternatively, run npx seo-geo-optimizer --bolt to auto-install into .bolt/prompt.

Any other AI IDE or assistant

If your IDE isn't listed, the pattern is always the same:

1. Find where your IDE reads persistent AI instructions (rules file, system prompt, custom instructions, context file)
2. Paste the full contents of skill/SEO_GEO_SKILL.md there
3. Start a new session

The skill file is plain Markdown. It works anywhere an AI can read text.

After install — tell your AI this

Read and activate the SEO & GEO Optimizer skill, then start the process.

That's the trigger phrase. Your AI will confirm it read the full file, then begin Phase 1.

What happens after activation

Phase 0   Read the entire skill file (Part 1 to 15) — confirm before proceeding
Phase 1   Complete all 40 intake questions (Part 3)
Phase 2   SEO Competitor analysis (3–5 real SEO competitors — Part 4)
Phase 3   Keyword & Opportunity Gap Assessment
Phase 4   Generate Execution Plan Report (EPR) → Approval Required
Phase 5   Execute Tier 1: all meta tags + Organization + WebSite schema → reports → stops
Phase 6   Execute Tier 2: Core Web Vitals + H1/H2 structure + Open Graph + schema → stops
Phase 7   Execute Tier 3: FAQPage/HowTo/Author schema + topic cluster + internal links → stops
Phase 8   Execute Tier 4: GEO restructuring + AI parsability + entity optimization → stops
Phase 9   Execute Tier 5: Content SEO & Blog optimization → reports → stops
Phase 10  Full verification checklist — every tool, every item, pass/fail
Phase 11  Maintenance monitoring setup (Part 11)
Phase 12  Timeline & Maintenance Schedule (Part 12)
Phase 13  Official Reference Handover (Part 15)
Phase 14  Skill Completion & Final Audit REPORT

The AI stops after every phase, reports what was done, and asks before continuing.

What gets optimized

Technical SEO

• All HTML meta tags — <title>, <meta description>, <canonical>, <robots>, <viewport>
• Open Graph and Twitter Cards for social sharing
• robots.txt and XML sitemap — submitted to Google AND Bing separately
• HTTPS, mobile-first indexing, URL structure, internal linking
• JavaScript rendering audit (critical for Bing — CSR/SPA apps are invisible to Bingbot)

Core Web Vitals

• LCP (Largest Contentful Paint) < 2.5s
• INP (Interaction to Next Paint) < 200ms — ⚠️ INP replaced FID in March 2024
• CLS (Cumulative Layout Shift) < 0.1

Schema Markup (JSON-LD — all templates included in skill)

Organization · WebSite · WebPage · Article · FAQPage · HowTo · Product · SoftwareApplication · LocalBusiness · BreadcrumbList · Person · AggregateRating

Google-Specific

• E-E-A-T signals (Experience, Expertise, Authoritativeness, Trustworthiness)
• Helpful Content system compliance
• Featured snippet optimization
• Google AI Overviews eligibility
• Google Search Console setup and monitoring

Bing-Specific

• Exact-match keyword placement (Bing weights this more heavily than Google)
• Social signals strategy — Facebook, LinkedIn, X (explicit Bing ranking factor)
• Bing Webmaster Tools setup and URL submission (completely separate from Google)
• JavaScript rendering fix for React/Vue/Angular CSR apps
• Bing Places listing

GEO — AI Search Visibility

• FAQPage schema (3.2× more likely to appear in Google AI Overviews)
• Self-contained H2 content blocks (AI engines read blocks, not whole pages)
• Definitive answer format — "X is Y." patterns AI citation engines prefer
• Entity optimization for LLM citation selection
• Table and list conversion for AI extraction
• Citation links to credible sources

Supported IDEs

| IDE | Auto-detect | Install path | | -------------------- | ----------- | -------------------------------------------------- | | Cursor | ✅ Yes | .cursor/rules/seo-geo-optimizer.mdc | | Windsurf | ✅ Yes | .windsurf/rules/seo-geo-optimizer.md | | GitHub Copilot | ✅ Yes | .github/copilot-instructions.md | | Lovable | ✅ Yes | .ai/seo-geo-optimizer.md | | Bolt | ✅ Yes | .bolt/prompt | | Replit | Manual | Paste into system prompt | | VS Code (any AI) | Manual | .github/copilot-instructions.md or system prompt | | Any AI assistant | Manual | Paste skill/SEO_GEO_SKILL.md as context |

Force install for a specific IDE

npx seo-geo-optimizer --cursor      # Cursor only
npx seo-geo-optimizer --windsurf    # Windsurf only
npx seo-geo-optimizer --copilot     # GitHub Copilot only
npx seo-geo-optimizer --lovable     # Lovable only
npx seo-geo-optimizer --bolt        # Bolt only
npx seo-geo-optimizer --all         # All IDEs at once
npx seo-geo-optimizer --help        # Show all options

Repo structure

seo-geo-optimizer/
├── bin/
│   └── install.js          ← CLI installer (auto-detects + installs)
├── skill/
│   └── SEO_GEO_SKILL.md    ← The skill file — this is what the AI reads
├── package.json
├── CONTRIBUTING.md
├── LICENSE
└── README.md

Verified against

| Source | Version | | ---------------------------------- | ------------- | | Google Search Central | December 2025 | | Core Web Vitals — INP replaces FID | March 2024 | | Google June 2025 Core Update | June 2025 | | Bing Webmaster Guidelines | 2025 | | Schema.org vocabulary | Current |

Every recommendation inside the skill file includes its official source URL. When Google or Bing updates their guidelines, those links tell your AI exactly what changed.

Philosophy

No guessing. No autonomous changes. No generic advice.

The AI asks before acting. Plans before executing. Stops and reports after every phase. You approve every change — not silence, not a nod, written approval only.

The AI is your analyst and planner. You are the decision-maker.

Contributing

Found a ranking factor that changed? Open a PR updating skill/SEO_GEO_SKILL.md with the new official reference link. Read CONTRIBUTING.md first.

License

MIT — free to use, modify, and share.

Author

Built by Aryan Panwar