Agent skill

SEO Drift Monitor

by AgriciDaniel in AgriciDaniel/claude-seo

Captures baselines of a page's SEO-critical elements, compares later snapshots against them and flags regressions by severity, like version control for on-page SEO.

MITAuto-check passedMarketing & SEO

Install SEO Drift Monitor

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

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

GitHub CLI
$ gh skill install AgriciDaniel/claude-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/claude-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
19k
Used in
1 other repo
Token cost
~1.9k tokens
SKILL.md length
653 words
Files
2 (incl. references)
Skills in repo
33
Repo updated
First seen
Licence
MIT

At a glance

Captures baselines of a page's SEO-critical elements, compares later snapshots against them and flags regressions by severity, like version control for on-page SEO.

  • Works in 6 steps: Validate URL (SSRF protection via… → Fetch page via… → Parse HTML via… → …
  • Capturing an SEO baseline before a site deployment
  • SKILL.md covers Commands, What It Captures, How Comparison Works and Storage, plus 7 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

The skill offers three commands: baseline to snapshot a URL as a known-good state, compare to check the current page against the stored baseline, and history to list past changes and comparisons. A baseline records the title, meta description, canonical URL, robots directives, H1 to H3 headings, JSON-LD schema, Open Graph tags, Core Web Vitals, HTTP status and SHA-256 hashes of the HTML and the schema.

Comparison applies 17 rules across three severity levels, critical, warning and info, with response times from immediate to review at convenience; the full rule set sits in a comparison-rules reference. Data is stored locally in a SQLite database under the user's cache folder, with baseline and comparison tables, and URLs are normalized (lowercase host, default ports and UTM parameters removed, sorted queries, trailing slashes stripped) so matches are consistent. URL validation protects against SSRF before a page is fetched.

When your agent uses it

  • Capturing an SEO baseline before a site deployment
  • Checking whether a release broke titles, canonicals or schema
  • Reviewing the history of SEO changes on a page

Example prompts

  • “Capture an SEO baseline for https://example.com/pricing before we deploy.”
  • “Compare the pricing page to its baseline and show anything that broke.”
  • “Show the SEO change history for our homepage.”

Requirements

  • The claude-seo plugin scripts that fetch and parse pages
  • Network access to the pages you monitor

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 "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run fetch_page.py
  3. Parse HTML via "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run parse_html.py
  4. Optionally fetch CWV via "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run 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 4b99de2. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    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 Monitor loads about 1.9k tokens when it runs, and up to ~3.3k if it reads all its reference files. Until then it costs about 94 tokens; SKILL.md has 653 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
~1.9k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.3k

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/claude-seo at commit 4b99de2, republished under its MIT licence (© AgriciDaniel). 653 words, ~1,853 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-invocable
true
argument-hint
baseline|compare|history <url>
license
MIT
metadata.author
AgriciDaniel
metadata.original_author
Dan Colta (Pro Hub Challenge)
metadata.version
2.4.2
metadata.category
seo

SEO Drift Monitor (April 2026)

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/claude-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 "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run fetch_page.py <URL>
  3. Parse HTML via "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run parse_html.py <URL>
  4. Optionally fetch CWV via "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run pagespeed_check.py <URL> (use --skip-cwv to skip)
  5. Hash HTML body and schema content (SHA-256)
  6. Store snapshot in SQLite

Execution:

bash
"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run drift_baseline.py <url>
"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run 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
"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run drift_compare.py <url>
"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run drift_compare.py <url> --baseline-id 5
"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run 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
"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run drift_report.py <comparison_json_file> --output drift-report.html

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

Command: history

Shows all baselines and comparisons for a URL.

Execution:

bash
"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run drift_history.py <url>
"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run 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 "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run 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?

© 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/claude-seo.

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

Open the folder on GitHubat commit 4b99de2

Used in 1 other repository

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

Compare with similar skills

SEO Drift Monitor 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 Monitor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
SEO Drift Monitor this skillAgriciDaniel/claude-seo19k1 repos~1.9kAutomated safety check: PassMIT
SEO Optimizerailabs-393/ai-labs-claude-skills4541 repos~3.2kAutomated safety check: PassMIT
E2E SEO Assistantirinabuht12-oss/marketing-skills4k—~1.9kAutomated safety check: PassNone
SEO Auditandrew-yangy/gru-ai155—~731Automated safety check: PassMIT
Geo Meta Tags Auditthedaviddias/Front-End-Checklist74k—~763Automated safety check: PassMIT
Business Website Setupsickn33/agentic-awesome-skills47k1 repos~6.2kAutomated safety check: PassMIT

Similar skills

  • 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.

    454 GitHub starsUsed in 1 repo~3.2k tokens
    Marketing & SEOAuto-check passed
  • E2E SEO Assistant

    irinabuht12-oss/marketing-skills

    Full SEO workflow covering technical audits, content gaps, backlink opportunities, on-page fixes, and content briefs.

    4k GitHub stars~1.9k tokensUpdated 16 days ago
    Marketing & SEOAuto-check passed
  • SEO Audit

    andrew-yangy/gru-ai

    Full website SEO audit with parallel subagent delegation. An agent skill from andrew-yangy/gru-ai.

    155 GitHub stars~731 tokensUpdated 7 mo ago
    Marketing & SEOAuto-check passed
  • Geo Meta Tags Audit

    thedaviddias/Front-End-Checklist

    Audits and fixes geo.region, geo.placename and geo.position meta tags on regional pages, noting where they help (Bing) and where they do not (Google).

    74k GitHub stars~763 tokensUpdated 3 days ago
    Marketing & SEOAuto-check passed
  • Business Website Setup

    sickn33/agentic-awesome-skills

    Website page register: URL, title, meta description, search intent, NAP block, schema type, canonical, indexability and Core Web Vitals target.

    47k GitHub starsUsed in 1 repo~6.2k tokens
    Marketing & SEOAuto-check passed
  • SEO Checker

    hanzili/hanzi-browse

    Audit web pages for SEO issues in a real browser. An agent skill from hanzili/hanzi-browse.

    177 GitHub stars~1.9k tokensUpdated 5 mo ago
    Marketing & SEOAuto-check passed

More from AgriciDaniel/claude-seo

All 33 skills in this repo
  • Hreflang and International SEO

    AgriciDaniel/claude-seo

    Audits, validates and generates hreflang tags for multi-language and multi-region sites in HTML, HTTP headers or XML sitemaps, flagging common code and return-tag mistakes.

    19k GitHub starsUsed in 5 repos~3.4k tokens
    Auto-check passed
  • Google SEO APIs

    AgriciDaniel/claude-seo

    Pulls real Google data for SEO work: Search Console, PageSpeed Insights, CrUX field data, the Indexing API and GA4 organic traffic, through /seo google commands.

    19k GitHub starsUsed in 1 repo~4.2k tokens
    Auto-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
    Auto-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
    Auto-check passed
  • FLOW SEO Framework

    AgriciDaniel/claude-seo

    Brings the FLOW framework's stage-specific SEO prompts into the agent, from keyword discovery through backlinks, on-page work and conversion to local SEO, loaded on demand.

    19k GitHub starsUsed in 2 repos~1.4k tokens
    Auto-check passed
  • SEO Image Generator

    AgriciDaniel/claude-seo

    Generates Open Graph previews, blog hero images, product photos and infographics for SEO use through Gemini image tools and the banana extension.

    19k GitHub starsUsed in 2 repos~2.1k tokens
    Auto-check passed

Works with

Categories

Questions about SEO Drift Monitor

What does SEO Drift Monitor do?

Captures baselines of a page's SEO-critical elements, compares later snapshots against them and flags regressions by severity, like version control for on-page SEO. The skill offers three commands: baseline to snapshot a URL as a known-good state, compare to check the current page against the stored baseline, and history to list past changes and comparisons. A baseline records the title, meta description, canonical URL, robots directives, H1 to H3 headings, JSON-LD schema, Open Graph tags, Core Web Vitals, HTTP status and SHA-256 hashes of the HTML and the schema.

When should I use SEO Drift Monitor?

SEO Drift Monitor fits situations like: capturing an SEO baseline before a site deployment; checking whether a release broke titles, canonicals or schema; reviewing the history of SEO changes on a page.

How do I install SEO Drift Monitor in Claude Code?

Run `npx skills add AgriciDaniel/claude-seo --skill seo-drift -a claude-code`. Or copy the skill folder (skills/seo-drift in AgriciDaniel/claude-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 Monitor in Codex?

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

Can I use SEO Drift Monitor 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/claude-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 Monitor need to run?

SKILL.md names no scripts, command-line tools or credentials: SEO Drift Monitor is instructions for the agent only. Our summary lists: The claude-seo plugin scripts that fetch and parse pages; Network access to the pages you monitor.

Does SEO Drift Monitor 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 Monitor 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 Monitor use?

SEO Drift Monitor 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 Monitor use?

About 1.9k tokens (SKILL.md is roughly 7.4k 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 Monitor?

Skills that share tags, products or a category with SEO Drift Monitor: SEO Optimizer (ailabs-393/ai-labs-claude-skills, 454 stars), E2E SEO Assistant (irinabuht12-oss/marketing-skills, 4k stars), SEO Audit (andrew-yangy/gru-ai, 155 stars) and Geo Meta Tags Audit (thedaviddias/Front-End-Checklist, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains SEO Drift Monitor?

AgriciDaniel (a GitHub user) maintains it in AgriciDaniel/claude-seo, which has 18,574 GitHub stars. The repository holds 33 skills in this directory. The repository was last updated on October 4, 2026.

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