How to Install the GEO-SEO Claude Code Skill: Complete Setup Guide

The GEO-SEO Claude Code Skill installs via a one-line curl command that clones the repository, creates an isolated Python virtual environment at ~/.claude/skills/geo/.venv/, and registers AI-first SEO commands like /geo audit directly in Claude Code.

The GEO-SEO Claude Code Skill is a self-contained bundle that adds generative engine optimization capabilities to your Claude Code CLI. Developed in the zubair-trabzada/geo-seo-claude repository, this skill requires only a single bash command to set up an isolated environment with all Python dependencies, sub-skills, and agent configurations.

Prerequisites for Installing GEO-SEO Claude Code Skill

Before running the installer, ensure your system meets these baseline requirements. The [install.sh](https://github.com/zubair-trabzada/geo-seo-claude/blob/main/install.sh) script automatically checks for each prerequisite and provides download URLs if anything is missing.

• Git – Required to fetch the source code. Verify with git --version.
• Python 3.8+ – Needed to build the virtual environment. Check with python3 --version.
• Claude Code CLI – The execution runtime for the skill. Verify with claude --help.
• uv (Optional) – A fast Python installer that the script will use if available to accelerate dependency installation.
• Playwright (Optional) – For screenshot generation capabilities; can be installed later if skipped during initial setup.

Step-by-Step GEO-SEO Claude Code Skill Installation

One-Command Installation (Recommended)

For most macOS and Linux users, execute the single-line installer anywhere in your terminal:

curl -fsSL https://raw.githubusercontent.com/zubair-trabzada/geo-seo-claude/main/install.sh | bash

This command downloads and pipes the latest [install.sh](https://github.com/zubair-trabzada/geo-seo-claude/blob/main/install.sh) directly into bash, starting the fully automated setup process.

Manual Installation from Source

If you prefer to inspect the code or contribute to development, clone the repository first and run the installer locally:

git clone https://github.com/zubair-trabzada/geo-seo-claude.git
cd geo-seo-claude
./install.sh

This approach uses your local checkout rather than a fresh clone, making it ideal for testing modifications to the skill logic.

What the install.sh Script Configures

The [install.sh](https://github.com/zubair-trabzada/geo-seo-claude/blob/main/install.sh) script performs several atomic operations to ensure a clean installation:

1. Directory Structure – Creates the Claude Code hierarchy under ~/.claude/skills/geo/.
2. Skill Deployment – Copies the main geo/ skill directory and all sub-skills (e.g., geo-audit, geo-citability) into the appropriate folders.
3. Agent Setup – Installs all markdown agent files into ~/.claude/agents/ for parallel execution during audits.
4. Utility Installation – Copies Python scripts from scripts/ (such as fetch_page.py and citability_scorer.py) and JSON-LD templates from schema/ into the skill directory.
5. Virtual Environment – Builds an isolated Python environment at ~/.claude/skills/geo/.venv/ and installs dependencies from [requirements.txt](https://github.com/zubair-trabzada/geo-seo-claude/blob/main/requirements.txt).
6. Path Patching – Rewrites shebang lines in all executable scripts to point to the venv interpreter and updates markdown references to invoke the correct Python binary.
7. Optional Playwright – Interactively prompts to install Chromium browsers for screenshot capabilities.

Verifying Your GEO-SEO Claude Code Skill Installation

After the script completes, it runs a sanity check to confirm successful deployment. You can manually verify the installation by checking for these components:

• The main skill definition exists at ~/.claude/skills/geo/geo/SKILL.md.
• Sub-skills are present in ~/.claude/skills/geo/skills/geo-*/.
• Agent files are located in ~/.claude/agents/geo-*.md.
• The virtual environment interpreter is executable at ~/.claude/skills/geo/.venv/bin/python3.

If any verification fails, the installer outputs the specific missing component path to expedite troubleshooting.

Using the Skill After Installation

Once installed, open Claude Code and invoke any GEO command. The skill automatically routes requests through the isolated virtual environment, ensuring system-wide Python packages remain untouched.

/geo audit https://example.com
/geo quick https://example.com
/geo citability https://example.com/blog/article

Each command executes the corresponding sub-skill logic (defined in skills/geo-*/SKILL.md) using the venv-bound Python interpreter.

Managing Optional Playwright Browsers

If you skipped the Playwright installation during setup, add browser support later by running:

~/.claude/skills/geo/.venv/bin/python3 -m playwright install chromium

This installs the Chromium browser binary required for screenshot generation in geo-audit workflows.

Uninstalling GEO-SEO Claude Code Skill

To completely remove the skill, execute the companion script from the repository:

./uninstall.sh

Alternatively, manually delete the installation directories:

rm -rf ~/.claude/skills/geo ~/.claude/agents/geo-*.md

Summary

• One-line installation via curl and [install.sh](https://github.com/zubair-trabzada/geo-seo-claude/blob/main/install.sh) sets up the entire GEO-SEO Claude Code Skill ecosystem.
• Isolated environment created at ~/.claude/skills/geo/.venv/ prevents dependency conflicts with system Python.
• Automatic verification checks for SKILL.md, sub-skills, agents, and interpreter executability after installation.
• Commands like /geo audit become available immediately in Claude Code, routing to the virtual environment automatically.
• Optional Playwright browsers can be added post-installation for screenshot generation capabilities.

Frequently Asked Questions

What are the minimum system requirements for GEO-SEO Claude Code Skill?

You need Git, Python 3.8 or higher, and the Claude Code CLI installed on a macOS or Linux system. The [install.sh](https://github.com/zubair-trabzada/geo-seo-claude/blob/main/install.sh) script validates these prerequisites before proceeding and provides direct download links if any tool is missing.

Where is the GEO-SEO Claude Code Skill installed on my system?

The skill installs into ~/.claude/skills/geo/ with its isolated Python virtual environment located at ~/.claude/skills/geo/.venv/. Agent configurations reside in ~/.claude/agents/ and utility scripts are stored under ~/.claude/skills/geo/scripts/.

Can I install GEO-SEO Claude Code Skill on Windows?

The official [install.sh](https://github.com/zubair-trabzada/geo-seo-claude/blob/main/install.sh) script is designed for bash-compatible environments (macOS and Linux). Windows users should run the installation within WSL2 (Windows Subsystem for Linux) to ensure proper symlink and shebang handling.

How do I update the GEO-SEO Claude Code Skill to the latest version?

Re-run the one-line curl installer command. The script detects existing installations and overwrites skill files, agent definitions, and Python dependencies while preserving your virtual environment structure. Alternatively, pull the latest changes in your local git repository and execute ./install.sh again to refresh the installation.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}