SEO Agentic (Antigravity / Claude / Codex)

An LLM-first SEO analysis skill for agent IDEs, with 19 specialized sub-skills, 7 specialist agents, and 29 scripts used as evidence collectors and workflow automation.

IDE Compatibility

• Antigravity IDE (.agent/skills/seo)
• Claude Code (~/.claude/skills/seo)
• Codex (~/.codex/skills/seo)

🚀 Getting Started (Claude Code)

Important: These are natural language commands typed in the Claude Code chat window — not terminal commands. Do not type them in a shell.

Step 1 — Clone and open in Claude Code

git clone https://github.com/buithang/seo-agentic.git
cd seo-agentic
pip install requests beautifulsoup4

Open Claude Code, then open the seo-agentic folder as your working directory.

Step 2 — Create your first project

Type this in the Claude Code chat:

project new MyBlog myblog.com

This creates a project profile at ~/.seo-projects/myblog/context.md and sets it as active. Fill in the brand, audience, and tone fields — skills use them automatically.

Other project commands:

project list              ← show all projects, mark active
project switch diverFi    ← switch active project
project status            ← show current project context

Step 3 — Run your first audit

seo audit myblog.com

Or use your project name directly (no need to type the URL):

seo audit MyBlog

Step 4 — Write content

content write What is DeFi and why it matters

The skill will research the topic, propose an outline, wait for your approval, then write the full article in your writing voice.

Note: content write requires a Writing DNA file at ~/.seo-voices/<your-name>.md. Copy the template first: cp resources/context/writing-dna.template.md ~/.seo-voices/your-name.md

All available commands

See SKILL.md for the full command list.

📦 Current Inventory

• Specialized sub-skills: 19
• Specialist agents: 7
• Scripts in scripts/: 29 (25 Python + 1 shell + 1 JS + 2 voice shell scripts)

✨ Features

🧠 LLM-First Workflow

This skill is designed for reasoning-first SEO analysis:

1. Collect page evidence (read_url_content first, scripts optional).
2. Analyze with LLM using explicit proof for each finding.
3. Apply confidence labels (Confirmed, Likely, Hypothesis).
4. Prioritize by impact and effort.
5. Produce a structured action plan.

Required Rubric

All audits should apply:

• resources/references/llm-audit-rubric.md

The rubric standardizes:

• evidence format (Finding, Evidence, Impact, Fix)
• severity (Critical, Warning, Pass, Info)
• confidence labeling
• output contract for audit reports

🤖 Specialist Agents

• Technical SEO — crawlability, indexability, security, mobile, JS rendering
• Content Quality — E-E-A-T scoring, AI content detection
• Performance — Core Web Vitals (LCP, INP, CLS) analysis
• Schema Markup — JSON-LD detection, validation, generation
• Sitemap — XML sitemap validation, quality gates
• Visual Analysis — screenshots, above-the-fold, responsiveness (Playwright)
• Verifier (Global) — dedupe/contradiction suppression before final reporting

📚 Reference Data (Updated Feb 2026)

• Core Web Vitals thresholds (INP replaced FID)
• E-E-A-T framework (Sept 2025 QRG + Dec 2025 core update)
• Schema.org types — active, restricted, deprecated
• Content quality gates & word count minimums
• Google SEO quick reference
• LLM audit rubric for consistent outputs

🏭 Industry Templates

Pre-built strategy templates for: SaaS, E-commerce, Local Business, Publisher/Media, Agency, and Generic businesses.

✍️ Writing Content in Your Voice

The content write sub-skill writes SEO articles in your personal writing style. It learns from every article you write and gets better over time.

How it works

Three phases, one command:

1. Research + outline — Web search + SERP analysis, gap identification, outline proposal. You approve before writing starts.
2. Writing — Full article in your voice, following your hard stops and style rules.
3. DNA Review — Automatic after every draft. The skill proposes learnings from the article (new examples, signature phrases, pattern refinements). You approve each one.

Approved learnings accumulate in ~/drafts/writing-dna-learnings.md. When you have enough, run merge dna to fold them back into your DNA file with a full diff preview.

Step 1: Create your Writing DNA file

Your Writing DNA is a personal voice profile — it tells the skill how you sound, what you never do, and how you think.

# Copy the template
cp resources/context/writing-dna.template.md ~/.seo-voices/your-name.md

# Edit it with your own examples, rules, and patterns

The template has sections for:

• Who I am — your background and what makes your perspective different
• How I sound — example hooks, body paragraphs, and disclaimers in your voice
• Signature phrases — recurring structures you use
• Hard stops — things you never do (e.g., "never open with a definition")
• Thinking patterns — how you move from theory to reality to stakes

The DNA file lives at ~/.seo-voices/ and is never committed to git. It's yours.

Step 2: Write an article

content write What is DeFi and why I almost lost everything

# With a brief:
content write What is DeFi
Brief: perspective from someone who actually used DeFi, target: new investors

The skill will:

1. Search the web and fetch top-ranking pages for your keyword
2. Show you an outline with angle, H2/H3 structure, and a hook draft
3. Wait for your approval (ok / yes)
4. Write the full article in your voice
5. Save it to ~/drafts/<slug>-draft.md
6. Run DNA Review automatically

Step 3: Approve DNA learnings

After the draft is saved, the skill presents proposals one by one:

DNA Proposal #1 — Examples

"[excerpt from the article that shows a strong voice pattern]"

Reason: Short-line break after a claim — not yet in DNA, very characteristic

Diff:
  Section: How I sound — Body section
+ "[excerpt]" ← short-line break after claim

Save to learnings? (y/n/edit)

• y — save this learning
• n — skip
• edit [your version] — save your edited version instead

Step 4: Merge learnings into your DNA

When you've written enough articles (3–5 is a good point), merge:

merge dna

The skill will:

1. Load ~/drafts/writing-dna-learnings.md
2. Deduplicate against your current DNA
3. Show a full diff preview with every proposed change
4. Resolve any conflicts with you
5. Update ~/.seo-voices/<name>.md with a version bump
6. Archive the learnings log

Word count defaults

Draft location

Every article saves to ~/drafts/<slug>-draft.md with frontmatter:

---
title: What is DeFi and why I almost lost everything
keyword: what is defi
date: 2026-04-17
status: draft
word_count: 1450
---

🔧 Installation (All IDEs)

Quick Install Script (Antigravity / Claude / Codex)

# 1) Clone
git clone https://github.com/buithang/seo-agentic.git
cd seo-agentic

# 2) Install for your target
# Antigravity (project-local):
bash install.sh --target antigravity --project-dir /path/to/your/project

# Claude:
bash install.sh --target claude

# Codex:
bash install.sh --target codex

# Global user install (Claude + Codex):
bash install.sh --target global

# All targets (Antigravity + Claude + Codex):
bash install.sh --target all --project-dir /path/to/your/project

# Install from another local checkout:
bash install.sh --target codex --repo-path /path/to/seo-agentic

Install directly from GitHub (remote source mode):

curl -fsSL https://raw.githubusercontent.com/buithang/seo-agentic/main/install.sh | \
  bash -s -- --target codex

Manual Installation

Step 1: Clone the Repository

git clone https://github.com/buithang/seo-agentic.git

Step 2: Install Python Dependencies

pip install requests beautifulsoup4

Optional — for visual analysis (screenshots & layout checks):

pip install playwright && playwright install chromium

Step 3: Choose Target Directory (Manual Install)

If you prefer not to use install.sh, copy or symlink manually:

#### Antigravity IDE (project-local)

mkdir -p .agent/skills
cp -r /path/to/seo-agentic .agent/skills/seo
# or: ln -s /path/to/seo-agentic .agent/skills/seo

#### Claude Code (user-global)

mkdir -p ~/.claude/skills
cp -r /path/to/seo-agentic ~/.claude/skills/seo
# or: ln -s /path/to/seo-agentic ~/.claude/skills/seo

#### Codex (user-global)

mkdir -p ~/.codex/skills
cp -r /path/to/seo-agentic ~/.codex/skills/seo
# or: ln -s /path/to/seo-agentic ~/.codex/skills/seo

Step 4: Verify Triggering

The skill will auto-trigger when you mention SEO-related keywords in your IDE. Try:

• "Run an SEO audit on example.com"
• "Check the schema markup on my homepage"
• "Analyze Core Web Vitals for my site"
• "Create an SEO plan for my SaaS product"

💬 Example Prompts (https://diverFi.com)

How Prompts Route to Agents & Scripts

The IDE uses an LLM orchestration layer to match your natural language intent to the correct underlying sub-skill (e.g., seo-hreflang.md, seo-schema.md). You do not need to use explicit flags or commands.

• To run a specific test: Ask for it specifically (e.g., "Check hreflang"). The LLM will only trigger the necessary scripts.
• To force ALL agents/tests: Ask for a "full, comprehensive audit running all checks". The LLM will route this to seo-audit.md, which acts as the master orchestrator calling all available scripts and analyzing the combined output.

Here's how specific phrases map to the skill's capabilities:

Domain vs URL vs Blog Post — What's Different?

🌐 Full Domain Audit

Run a full SEO audit for https://diverfi.com and prioritize fixes by impact.

📄 Single Page / Blog Post Analysis

Analyze this article: https://www.diverfi.com/learn/defi-basics/01-what-is-defi

Do a single-page SEO analysis of https://diverfi.com and show critical issues first.

🔧 Technical SEO

Analyze technical SEO for https://diverFi.com (robots, crawlability, canonicals, redirects, headers).

📝 Content Quality & E-E-A-T

Review content quality and E-E-A-T signals on https://diverFi.com and suggest concrete rewrites.

🏷️ Schema Markup

Check schema markup on https://diverFi.com, validate errors, and generate corrected JSON-LD.

⚡ Performance & Core Web Vitals

Run Core Web Vitals analysis on https://diverFi.com and break down LCP subparts.

🤖 GEO / AI Search Readiness

Evaluate GEO readiness for https://diverFi.com (AI crawler access, llms.txt, citation structure).

🎯 Answer Engine Optimization (AEO)

Analyze AEO signals for https://diverFi.com — Featured Snippet targeting, PAA optimization, Knowledge Panel readiness.

🔗 Link Profile Analysis

Analyze internal link structure and backlink profile for https://diverFi.com.

🏛️ Entity SEO / Knowledge Graph

Check entity SEO for https://diverFi.com — Wikidata presence, sameAs links, Knowledge Graph signals.

📊 Competitor Topic Gap

Find content gaps between https://diverFi.com and competitors https://www.binance.com/en/academy https://www.fidelity.com/learning-center/trading-investing/crypto/.

🌍 Hreflang / International SEO

Validate hreflang implementation on https://diverFi.com — BCP-47 tags, bidirectional links, x-default.

📡 IndexNow

Check IndexNow implementation for https://diverFi.com with key abc123def456.

📋 Topical Cluster Planning

Create a topical authority cluster plan for https://diverFi.com covering cybersecurity topics.

📈 Google Search Console (requires credentials)

Pull GSC performance data for https://diverFi.com and identify striking-distance keywords.

🗺️ Sitemap Audit

Audit sitemap quality for https://diverFi.com and flag missing, redirected, or noindex URLs.

🖼️ Image SEO

Run image SEO checks for https://diverFi.com (alt text, lazy loading, dimensions, format suggestions).

📋 Strategic SEO Plan

Create a 6-month SEO strategy for https://diverFi.com with milestones and KPIs.

📱 Visual / Mobile Analysis

Take desktop and mobile screenshots of https://diverFi.com and analyze above-the-fold content.

Run Everything at Once

To run all analysis types on a single URL:

Run a complete SEO audit on https://diverFi.com — include technical, content, schema, performance,
links, GEO, AEO, entity SEO, and sitemap analysis. Provide a prioritized action plan.

Example generated outputs:

• FULL-AUDIT-REPORT.md — comprehensive findings
• ACTION-PLAN.md — prioritized fixes

Example prompt and generated outputs

📊 Report Generation

You can generate reports in two ways:

1. LLM-first report in your IDE (Antigravity / Claude / Codex) (recommended for strategy + prioritization):

Run a full SEO audit for https://diverFi.com and produce a prioritized action plan with evidence for each finding.

1. Interactive HTML dashboard (recommended for shareable technical snapshots):

python3 scripts/generate_report.py "https://diverFi.com" --output seo-report-diverFi.html

The HTML report includes:

• overall score and category breakdown
• environment detection (platform/runtime inference)
• environment-specific fix plan
• section-level issues and recommendations
• readability "what to replace" suggestions

Example generated dashboard:

SEO report dashboard example

⚙️ Optional Script Workflow

Use scripts when you need additional verification or structured JSON outputs.

# Example target
URL="https://example.com"

# Fetch + parse HTML
python3 scripts/fetch_page.py "$URL" --output /tmp/page.html
python3 scripts/parse_html.py /tmp/page.html --url "$URL" --json

# Core checks
python3 scripts/robots_checker.py "$URL" --json
python3 scripts/llms_txt_checker.py "$URL" --json
python3 scripts/pagespeed.py "$URL" --strategy mobile --json
python3 scripts/security_headers.py "$URL" --json
python3 scripts/redirect_checker.py "$URL" --json
python3 scripts/social_meta.py "$URL" --json

# Content + structure checks
python3 scripts/readability.py /tmp/page.html --json
python3 scripts/internal_links.py "$URL" --depth 1 --max-pages 20 --json
python3 scripts/broken_links.py "$URL" --workers 5 --json
python3 scripts/article_seo.py "$URL" --json

# New analysis scripts
python3 scripts/hreflang_checker.py "$URL" --json
python3 scripts/entity_checker.py "$URL" --json
python3 scripts/duplicate_content.py "$URL" --json
python3 scripts/link_profile.py "$URL" --json
python3 scripts/competitor_gap.py "$URL" --competitor https://competitor.com --json
# python3 scripts/gsc_checker.py "$URL" --credentials creds.json --json  # requires GSC credentials
# python3 scripts/indexnow_checker.py "$URL" --key YOUR_KEY --json          # requires IndexNow key

# Generic verifier stage (can be used by any workflow before final reporting)
python3 scripts/finding_verifier.py --findings-json raw-findings.json --json

Generate a single HTML dashboard if needed:

python3 scripts/generate_report.py "$URL"

🛡️ Critical Rules Enforced

📋 Requirements

🙏 Credits

This project is heavily built from [claude-seo](https://github.com/AgriciDaniel/claude-seo) by [AgriciDaniel](https://github.com/AgriciDaniel). All core SEO logic, reference data, agent definitions, utility scripts, and sub-skill instructions originate from that project.

This repository restructures and adapts the content to function as a compatible skill package for Antigravity IDE, Claude Code, and Codex, while preserving the same core skill layout (SKILL.md + scripts/ + resources/).

📄 License

Licensed under the MIT License. See LICENSE.

Portions are derived from claude-seo, which is also MIT-licensed.