SEO Skills: Universal AI SEO Agent & Technical Optimization Suite

SEO Skills is the universal, open-source AI search engine optimization skill suite and audit engine for modern AI coding agents — including Anthropic Claude Code, Google Antigravity IDE, Cursor IDE, Windsurf Cascade, GitHub Copilot, OpenAI ChatGPT / Codex, Cline & Roo Code, Aider CLI, and DeepSeek R1.

Built upon the Holistic Semantic SEO Framework, Google Information Gain Patent US 11,562,019 B2, 2026 Google Search Essentials, and the open Agent Skills Specification, SEO Skills delivers 27 modular sub-skills, 18 specialist sub-agents, first-party Python adapters (DataForSEO, Firecrawl, Bing Webmaster, IndexNow), optional third-party vendor MCP (Ahrefs, SE Ranking, Profound, Banana, Unlighthouse), and a deterministic zero-telemetry Python execution engine.

---

📈 Real-World Performance & Empirical Results

SEO Skills is proven across both brand-new domains launched from scratch and established websites recovering from algorithmic decay:

1. Brand New Sites: Instant Google Indexation & Organic Ranking

Empirical Google Search Console trajectory for brand new domains launched with SEO Skills structured EAV entity modeling and Schema.org graphs:

Figure 1 (illustrative): Google Search Console performance UI. Property, date range, and filters are whatever appears in the screenshot — not a live export from this repository.

Figure 2 (illustrative): GSC query/page table for an example property. Treat as a UI example, not packaged ranking proof.

---

2. Multi-Engine Indexation: Bing & IndexNow Batch Discovery

Accelerated crawl discovery and top-tier rankings on Bing Search via unified Bing Webmaster and IndexNow automation:

Figure 3 (illustrative): Bing Webmaster Tools UI for an example site and date range.

---

3. Established Domain Recovery: Algorithmic Turnaround

Resolving technical debt, deprecated schemas, and thin content to recover decaying legacy properties:

Figure 4 (illustrative): Search performance chart for a recovering property. Filters and dates are those shown in the image.

---

Installation

Clone the repository and open it as the agent workspace.

git clone https://github.com/seoskillsai/seo-skills-ai.git
cd seo-skills-ai
npx @seoskillsai/cli add cursor

Or without cloning first:

npx @seoskillsai/cli add cursor

Unix / macOS:

bash install.sh

Windows (PowerShell):

powershell -ExecutionPolicy Bypass -File .\install.ps1

Then point Claude Code, Cursor, Antigravity, Windsurf, Codex, or Cline at this folder. Skills load from skills/. Optional Playwright Chromium is installed by install.sh / install.ps1 for screenshots.

Claude Code CLI

/plugin marketplace add seoskillsai/seo-skills-ai
/plugin install seo-skills@seoskillsai-seo-skills
/seo setup
/seo doctor

Cline / Roo MCP

Copy config/cline_mcp_settings.json into your Cline MCP settings. Tools are not auto-approved; the host must confirm seo_audit and seo_drift because they fetch the URL you pass.

---

🏛️ What Makes SEO Skills Superior to Legacy Tools

Traditional SEO auditing tools (such as standalone browser extensions or single-agent plugins) rely on superficial regex scripts, obsolete Schema.org types, and generic prompt checklists. SEO Skills operates as an autonomous, multi-agent intelligence layer that executes deterministic code, inspects DOM rendering pipelines, and enforces holistic semantic authority:

This is the beginning of the README. Read the rest at the original. Read the full README ↗