Agent skill

SEO Drift

by AgriciDaniel in AgriciDaniel/codex-seo

SEO drift monitoring: capture baselines of SEO-critical elements, detect changes, and track regressions over time.

MITAuto-check passedMarketing & SEO

Install SEO Drift

skills CLI
$ npx skills add AgriciDaniel/codex-seo --skill seo-drift -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install AgriciDaniel/codex-seo seo-drift --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/AgriciDaniel/codex-seo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/seo-drift .claude/skills/seo-drift && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
seo-drift
GitHub stars
799
Used in
1 other repo
Token cost
~2k tokens
SKILL.md length
787 words
Files
2 (incl. references)
Skills in repo
18
Repo updated
First seen
Licence
MIT

At a glance

SEO drift monitoring: capture baselines of SEO-critical elements, detect changes, and track regressions over time.

  • Works in 6 steps: Validate URL (SSRF protection via… → Fetch page via scripts/fetch_page.py → Parse HTML via scripts/parse_html.py → …
  • User says SEO drift
  • SKILL.md covers Shared Data Cache, Commands, What It Captures and How Comparison Works, plus 9 more sections
  • Calls python

What it does

SEO Drift is an agent skill from AgriciDaniel/codex-seo. SEO drift monitoring: capture baselines of SEO-critical elements, detect changes, and track regressions over time. Git for SEO — baseline, diff, and track changes to your on-page SEO. Use when user says "SEO drift", "baseline", "track changes", "did anything break", "SEO regression", "compare SEO", "before and after", "monitor SEO changes", or "deployment check".

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/comparison-rules.md`).

It sits in Marketing & SEO, covering On-page SEO and Deployment. It works with Git. The repository describes itself as: Codex-first SEO skill suite. 26 workflows, 24 TOML agents, DataForSEO/Gemini/Google/Firecrawl integrations, GEO/AEO, CWV, schema, backlinks, local/maps, and deterministic reports. The licence is MIT.

When your agent uses it

  • User says SEO drift
  • Did anything break
  • Before and after
  • Monitor SEO changes

Example prompts

  • “SEO drift”
  • “baseline”
  • “track changes”
  • “/seo-drift”

Requirements

  • Python 3

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Validate URL (SSRF protection via google_auth.validate_url())
  2. Fetch page via scripts/fetch_page.py
  3. Parse HTML via scripts/parse_html.py
  4. Optionally fetch CWV via scripts/pagespeed_check.py (use --skip-cwv to skip)
  5. Hash HTML body and schema content (SHA-256)
  6. Store snapshot in SQLite

What it can do on your machine

Read from SKILL.md and the folder at commit 9a644f6. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

SEO Drift loads about 2k tokens when it runs, and up to ~3.4k if it reads all its reference files. Until then it costs about 94 tokens; SKILL.md has 787 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~94
When it runs · the whole SKILL.md, loaded when a task matches
~2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from AgriciDaniel/codex-seo at commit 9a644f6, republished under its MIT licence (© AgriciDaniel). 787 words, ~2,035 tokens.

Download SKILL.mdSave it as .claude/skills/seo-drift/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
seo-drift
description
SEO drift monitoring: capture baselines of SEO-critical elements, detect changes, and track regressions over time. Git for SEO — baseline, diff, and track changes to your on-page SEO. Use when user says "SEO drift", "baseline", "track changes", "did anything break", "SEO regression", "compare SEO", "before and after", "monitor SEO changes", or "deployment check".
user-invokable
true
argument-hint
baseline|compare|history <url>
license
MIT
metadata.author
AgriciDaniel
metadata.original_author
Dan Colta (Pro Hub Challenge)
metadata.version
1.9.6
metadata.category
seo

SEO Drift Monitor (April 2026)

Shared Data Cache

Step 0 -- Check shared data cache:

Before gathering, check .seo-cache/ for reusable context from related SEO skills. Reference: ../seo/references/shared-data-cache.md for schemas and dependency map.

Check these cache files when present:

  • .seo-cache/site-meta.json for domain, business type, industry, and crawl context

  • .seo-cache/audit-scores.json for prior full-audit priorities

  • .seo-cache/pages/{url-slug}/page-analysis.json for page-level context when a URL is provided

  • If found: parse and use clearly valid fields (note "Using cached [X] from [date]")

  • If missing, corrupt, or irrelevant: continue with fresh evidence

  • If the user says "refresh" or "re-run": ignore cache reads and overwrite on write

Git for your SEO. Capture baselines, detect regressions, track changes over time.


Commands

CommandPurpose
/seo drift baseline <url>Capture current SEO state as a "known good" snapshot
/seo drift compare <url>Compare current page state to stored baseline
/seo drift history <url>Show change history and past comparisons

What It Captures

Every baseline records these SEO-critical elements:

ElementFieldSource
Title tagtitleparse_html.py
Meta descriptionmeta_descriptionparse_html.py
Canonical URLcanonicalparse_html.py
Robots directivesmeta_robotsparse_html.py
H1 headingsh1 (array)parse_html.py
H2 headingsh2 (array)parse_html.py
H3 headingsh3 (array)parse_html.py
JSON-LD schemaschema (array)parse_html.py
Open Graph tagsopen_graph (dict)parse_html.py
Core Web Vitalscwv (dict)pagespeed_check.py
HTTP status codestatus_codefetch_page.py
HTML content hashhtml_hash (SHA-256)Computed
Schema content hashschema_hash (SHA-256)Computed

How Comparison Works

The comparison engine applies 17 rules across 3 severity levels. Load references/comparison-rules.md for the full rule set with thresholds, recommended actions, and cross-skill references.

Severity Levels
LevelMeaningResponse Time
CRITICALSEO-breaking change, likely traffic lossImmediate
WARNINGPotential impact, needs investigationWithin 1 week
INFOAwareness only, may be intentionalReview at convenience

Storage

All data is stored locally in SQLite:

~/.cache/codex-seo/drift/baselines.db
Tables
  • baselines: Captured snapshots with all SEO elements
  • comparisons: Diff results with triggered rules and severities

URL normalization ensures consistent matching: lowercase scheme/host, strip default ports (80/443), sort query parameters, remove UTM parameters, strip trailing slashes.


Command: baseline

Captures the current state of a page and stores it.

Steps:

  1. Validate URL (SSRF protection via google_auth.validate_url())
  2. Fetch page via scripts/fetch_page.py
  3. Parse HTML via scripts/parse_html.py
  4. Optionally fetch CWV via scripts/pagespeed_check.py (use --skip-cwv to skip)
  5. Hash HTML body and schema content (SHA-256)
  6. Store snapshot in SQLite

Execution:

bash
python scripts/drift_baseline.py <url>
python scripts/drift_baseline.py <url> --skip-cwv

Output: JSON with baseline ID, timestamp, URL, and summary of captured elements.


Command: compare

Fetches the current page state and diffs it against the most recent baseline.

Steps:

  1. Validate URL
  2. Load most recent baseline from SQLite (or specific --baseline-id)
  3. Fetch and parse current page state
  4. Run all 17 comparison rules
  5. Classify findings by severity
  6. Store comparison result
  7. Output JSON diff report

Execution:

bash
python scripts/drift_compare.py <url>
python scripts/drift_compare.py <url> --baseline-id 5
python scripts/drift_compare.py <url> --skip-cwv

Output: JSON with all triggered rules, old/new values, severity, and actions.

After comparison, offer to generate an HTML report:

bash
python scripts/drift_report.py <comparison_json_file> --output drift-report.html

Show full SKILL.md (320 more words)Show less

Command: history

Shows all baselines and comparisons for a URL.

Execution:

bash
python scripts/drift_history.py <url>
python scripts/drift_history.py <url> --limit 10

Output: JSON array of baselines (newest first) with timestamps and comparison summaries.


Cross-Skill Integration

When drift is detected, recommend the appropriate specialized skill:

FindingRecommendation
Schema removed or modifiedRun /seo schema <url> for full validation
CWV regressionRun /seo technical <url> for performance audit
Title or meta description changedRun /seo page <url> for content analysis
Canonical changed or removedRun /seo technical <url> for indexability check
Noindex addedRun /seo technical <url> for crawlability audit
H1/heading structure changedRun /seo content <url> for E-E-A-T review
OG tags removedRun /seo page <url> for social sharing analysis
Status code changed to errorRun /seo technical <url> for full diagnostics

Error Handling

ScenarioAction
URL unreachableReport error from fetch_page.py. Do not guess state. Suggest user verify URL.
No baseline exists for URLInform user and suggest running baseline first.
SSRF blocked (private IP)Report validate_url() rejection. Never bypass.
SQLite database missingAuto-create on first use. No error.
CWV fetch fails (no API key)Store null for CWV fields. Skip CWV rules during comparison.
Page returns 4xx/5xxStill capture as baseline (status code IS a tracked field).
Multiple baselines existUse most recent unless --baseline-id specified.

Security

  • All URL fetching goes through scripts/fetch_page.py which enforces SSRF protection (blocks private IPs, loopback, reserved ranges, GCP metadata endpoints)
  • No curl, no subprocess HTTP calls -- only the project's validated fetch pipeline
  • All SQLite queries use parameterized placeholders (?), never string interpolation
  • TLS always verified -- no verify=False anywhere in the pipeline

Typical Workflows

Pre/Post Deployment Check
/seo drift baseline https://example.com     # Before deploy
# ... deploy happens ...
/seo drift compare https://example.com      # After deploy
Ongoing Monitoring
/seo drift baseline https://example.com     # Initial capture
# ... weeks later ...
/seo drift compare https://example.com      # Check for drift
/seo drift history https://example.com      # Review all changes
Investigating a Traffic Drop
/seo drift compare https://example.com      # What changed?
/seo drift history https://example.com      # When did it change?

Write to shared data cache

After completing all work, write a concise JSON summary to .seo-cache/ when the workflow produced durable findings. Use the schemas and naming rules in ../seo/references/shared-data-cache.md; include at least cache_type, analyzed_at, source URL/domain, key findings, issues, recommendations, and tool limitations. Add .seo-cache/ to .gitignore if it is missing.

© AgriciDaniel, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in skills/seo-drift of AgriciDaniel/codex-seo.

  • SKILL.md
  • references/comparison-rules.md

Open the folder on GitHubat commit 9a644f6

Used in 2 other repositories

We found 3 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in AgriciDaniel/codex-seo, which our catalogue first saw on October 7, 2026.

Compare with similar skills

SEO Drift next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

SEO Drift compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
SEO Drift this skillAgriciDaniel/codex-seo7991 repos~2kAutomated safety check: PassMIT
SEO AI Optimizerluongnv89/skills131—~2.7kAutomated safety check: PassMIT
SEO Keyword ClusteringAgriciDaniel/claude-seo19k2 repos~3.3kAutomated safety check: PassMIT
SEO Content Brief GeneratorAgriciDaniel/claude-seo19k2 repos~2.6kAutomated safety check: PassMIT
Nemoclaw Maintainer Normalize Title TagsNVIDIA/NemoClaw23k—~693Automated safety check: PassApache-2.0
SEO Optimizerailabs-393/ai-labs-claude-skills4551 repos~3.2kAutomated safety check: PassMIT

Similar skills

  • SEO AI Optimizer

    luongnv89/skills

    Audit and optimize websites for technical SEO, content SEO, and AI bot accessibility.

    131 GitHub stars~2.7k tokensUpdated today
    Marketing & SEOAuto-check passed
  • SEO Keyword Clustering

    AgriciDaniel/claude-seo

    Clusters keywords by how much their search results overlap and designs a hub-and-spoke content plan with an internal link matrix and an interactive cluster map.

    19k GitHub starsUsed in 2 repos~3.3k tokens
    Marketing & SEOAuto-check passed
  • SEO Content Brief Generator

    AgriciDaniel/claude-seo

    Builds research-backed SEO content briefs with competitor scoring, per-section word counts and page-type templates, for new pages or improving existing ones.

    19k GitHub starsUsed in 2 repos~2.6k tokens
    Marketing & SEOAuto-check passed
  • Remove bracketed NemoClaw tags from GitHub issue and PR titles.

    23k GitHub stars~693 tokensUpdated today
    Marketing & SEOAuto-check passed
  • SEO Optimizer

    ailabs-393/ai-labs-claude-skills

    This skill should be used when analyzing HTML/CSS websites for SEO optimization, fixing SEO issues, generating SEO reports, or implementing SEO best practices.

    455 GitHub starsUsed in 1 repo~3.2k tokens
    Marketing & SEOAuto-check passed
  • AI Citability Scorer

    zubair-trabzada/geo-seo-claude

    Scores how likely AI assistants are to quote passages from a web page and suggests rewrites that make those passages easier to extract.

    11k GitHub starsUsed in 2 repos~3.7k tokens
    Marketing & SEOAuto-check: notes

More from AgriciDaniel/codex-seo

All 18 skills in this repo
  • SEO Google

    AgriciDaniel/codex-seo

    Google SEO APIs: Search Console (Search Analytics, URL Inspection, Sitemaps), PageSpeed Insights v5, CrUX field data with 25-week history, Indexing API v3, and GA4 organic traffic.

    799 GitHub starsUsed in 2 repos~3.4k tokens
    Auto-check passed
  • SEO Dataforseo

    AgriciDaniel/codex-seo

    Live SEO data via DataForSEO MCP server. An agent skill from AgriciDaniel/codex-seo.

    799 GitHub starsUsed in 2 repos~4.6k tokens
    Auto-check passed
  • SEO Ecommerce

    AgriciDaniel/codex-seo

    E-commerce SEO analysis: Google Shopping visibility, Amazon marketplace intelligence, product schema validation, competitor pricing analysis, and marketplace keyword gaps.

    799 GitHub starsUsed in 2 repos~3k tokens
    Auto-check passed
  • SEO Sxo

    AgriciDaniel/codex-seo

    Search Experience Optimization: reads Google SERPs backwards to detect page-type mismatches, derives user stories from search intent signals, and scores pages from multiple persona perspectives.

    799 GitHub starsUsed in 2 repos~2.9k tokens
    Auto-check passed
  • SEO Page

    AgriciDaniel/codex-seo

    Deep single-page SEO analysis covering on-page elements, content quality, technical meta tags, schema, images, and performance.

    799 GitHub starsUsed in 5 repos~1.2k tokens
    Auto-check passed
  • SEO Schema

    AgriciDaniel/codex-seo

    Detect, validate, and generate Schema.org structured data. An agent skill from AgriciDaniel/codex-seo.

    799 GitHub starsUsed in 5 repos~1.6k tokens
    Auto-check passed

Works with

Categories

Questions about SEO Drift

What does SEO Drift do?

SEO drift monitoring: capture baselines of SEO-critical elements, detect changes, and track regressions over time. SEO Drift is an agent skill from AgriciDaniel/codex-seo. SEO drift monitoring: capture baselines of SEO-critical elements, detect changes, and track regressions over time.

When should I use SEO Drift?

SEO Drift fits situations like: user says SEO drift; did anything break; before and after; monitor SEO changes.

How do I install SEO Drift in Claude Code?

Run `npx skills add AgriciDaniel/codex-seo --skill seo-drift -a claude-code`. Or copy the skill folder (skills/seo-drift in AgriciDaniel/codex-seo) into .claude/skills/seo-drift in your project. Claude Code loads it when a task matches its description.

How do I install SEO Drift in Codex?

Run `npx skills add AgriciDaniel/codex-seo --skill seo-drift -a codex`. Or copy the skill folder (skills/seo-drift in AgriciDaniel/codex-seo) into .agents/skills/seo-drift in your project. Codex loads it when a task matches its description.

Can I use SEO Drift in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add AgriciDaniel/codex-seo --skill seo-drift -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/seo-drift, .gemini/skills/seo-drift, .github/skills/seo-drift and .opencode/skills/seo-drift in your project.

What does SEO Drift need to run?

Going by SKILL.md and its folder, SEO Drift needs the command-line tools its instructions call (python). Our summary lists: Python 3.

Does SEO Drift access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is SEO Drift safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does SEO Drift use?

SEO Drift is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does SEO Drift use?

About 2k tokens (SKILL.md is roughly 8.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.4k tokens, read only when the agent opens those files.

What are the alternatives to SEO Drift?

Skills that share tags, products or a category with SEO Drift: SEO AI Optimizer (luongnv89/skills, 131 stars), SEO Keyword Clustering (AgriciDaniel/claude-seo, 19k stars), SEO Content Brief Generator (AgriciDaniel/claude-seo, 19k stars) and Nemoclaw Maintainer Normalize Title Tags (NVIDIA/NemoClaw, 23k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains SEO Drift?

AgriciDaniel (a GitHub user) maintains it in AgriciDaniel/codex-seo, which has 799 GitHub stars. The repository holds 18 skills in this directory. The repository was last updated on September 11, 2026.

Source: AgriciDaniel/codex-seo on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.