seo-geo-optimizer

🚀 seo-geo-optimizer

The only AI skill that asks questions first, then does everything itself. Full SEO + GEO optimization — automated end-to-end by your IDE.

The tool automatically guides your AI assistant to generate and execute 14 rigorous, error-free phases of optimization for your site without asking you a single question after its initial interrogation. In essence, it asks you 40 questions to collect information on all possible states, handles generation of critical ranking components, formats the results for modern LLM-engines to utilize, and delivers concrete AI files, bypassing useless consultation completely. It is ideally geared for developers who view SEO optimization as a necessary but repetitive chore.

⚡ Quick Start

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.

Trigger the Skill

Once installed, the skill stays dormant in PASSIVE MODE. To activate it, open your AI chat and type: /seo or run seo-geo-optimizer

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

Once installed, type /seo in your Cursor AI or Composer session to activate.

Windsurf

Step 1 — Create the file .windsurf/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 .windsurf/rules
curl -o .windsurf/rules/seo-geo-optimizer.mdc \
  https://raw.githubusercontent.com/Aryanpanwar10005/seo-geo-optimizer/main/skill/SEO_GEO_SKILL.md

Once installed, type /seo in your Windsurf Cascade AI session to activate.

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

Once installed, type /seo in your Copilot Chat session inside VS Code to activate.

Claude Code

Step 1 — Create the file CLAUDE.md in your project root. Step 2 — Paste the full contents of skill/SEO_GEO_SKILL.md into it.

Alternatively, run npx seo-geo-optimizer --claude to auto-install.

Trae

Step 1 — Create the file .trae/rules.md in your project root. Step 2 — Paste the full contents of skill/SEO_GEO_SKILL.md into it.

Alternatively, run npx seo-geo-optimizer --trae to auto-install.

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.

Antigravity (Google IDE)

Step 1 — Create the project-level rules directory:

mkdir -p .gemini

Step 2 — Install the skill for the project:

curl -o .gemini/GEMINI.md \
  https://raw.githubusercontent.com/Aryanpanwar10005/seo-geo-optimizer/main/skill/SEO_GEO_SKILL.md

Global Installation (Alternative) If you want the skill to run across all projects automatically:

mkdir -p ~/.gemini
curl -o ~/.gemini/GEMINI.md \
  https://raw.githubusercontent.com/Aryanpanwar10005/seo-geo-optimizer/main/skill/SEO_GEO_SKILL.md

⚠️ WARNING: This will overwrite any existing ~/.gemini/GEMINI.md. Please back it up first, or set GEMINI_CLI_HOME to isolate your Gemini home directory.

Alternatively, run npx seo-geo-optimizer --antigravity --global to auto-install globally. Once installed, type /seo in your Antigravity session to activate.

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.

🤖 How It Works

Step 1: Trigger the skill (Phase 0 — Initialize) Type /seo or run seo-geo-optimizer in your AI chat. The skill will then run the intake questionnaire — 40 questions across 5 groups — to collect everything it needs before touching your site:

• Group A: Site identity (8 questions — URL, brand, description, founding year, etc.)
• Group B: Business type & goals (8 questions — type, audience, competitors, CMS, etc.)
• Group C: Current SEO state (8 questions — existing schema,