Agent skill

Single Page SEO Analysis

by AgriciDaniel in AgriciDaniel/claude-seo

Reviews one URL for on-page SEO, content quality, technical metadata, schema, images and performance, using concrete length and size thresholds.

MITAuto-check passedMarketing & SEO

Install Single Page SEO Analysis

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

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

GitHub CLI
$ gh skill install AgriciDaniel/claude-seo seo-page --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-page .claude/skills/seo-page && 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-page
GitHub stars
19k
Token cost
~1.1k tokens
SKILL.md length
469 words
Files
2
Skills in repo
33
Repo updated
First seen
Licence
MIT

At a glance

Reviews one URL for on-page SEO, content quality, technical metadata, schema, images and performance, using concrete length and size thresholds.

  • Reviewing the SEO of one landing page or blog post
  • SKILL.md covers What to Analyze, Output, DataForSEO Integration… and Error Handling
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Checking title, meta description and heading structure before publishing

What it does

The agent checks one page against a fixed list. On-page items include a title of 50 to 60 characters, a meta description of 150 to 160 characters, a single H1, a clean heading hierarchy, a short URL and sensible internal and external links. A script compares the title and description to catch templated metadata, such as a description that repeats the title and ends on a stock call to action.

Content checks cover word count by page type, readability, natural keyword density, author and experience signals and freshness. Technical checks cover the canonical tag, meta robots, Open Graph, Twitter Card and hreflang. Schema is detected and validated, and HowTo and FAQ rich results are no longer recommended. Images are flagged for missing alt text, file size over 200KB as a warning and over 500KB as critical, format and dimensions, with JavaScript lazy-loaders recognized so they are not falsely flagged.

When your agent uses it

  • Reviewing the SEO of one landing page or blog post
  • Checking title, meta description and heading structure before publishing
  • Validating schema markup and Open Graph tags on a single URL
  • Spotting oversized or poorly lazy-loaded images on a page

Example prompts

  • “Analyze https://example.com/blog/launch for on-page SEO and list the fixes.”
  • “Check the title, meta description and H1 on our pricing page.”
  • “Which images on this URL are too heavy, and what format should they use?”

Requirements

  • The claude-seo plugin scripts, for the metadata comparison

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.

    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

Single Page SEO Analysis loads about 1.1k tokens when it runs. Until then it costs about 37 tokens; SKILL.md has 469 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~37
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

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). 469 words, ~1,081 tokens.

Download SKILL.mdSave it as .claude/skills/seo-page/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
seo-page
description
Analyze one supplied URL across on-page, content, technical metadata, schema, images, and performance. Use only for a single-page review.
user-invocable
true
argument-hint
[url]
license
MIT
metadata.author
AgriciDaniel
metadata.version
2.4.2
metadata.category
seo

Single Page Analysis

What to Analyze

On-Page SEO
  • Title tag: 50-60 characters, includes primary keyword, unique
  • Meta description: 150-160 characters, compelling, includes keyword
  • Meta description is not a restatement of the title: run "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run metadata_template.py --title "<title>" --description "<desc>" --json (heuristic, deterministic string comparison). A description that opens by repeating its own title and closes on a stock CTA ("Try it free now.", "Start free!") is templated metadata, the shape bulk generation jobs produce site-wide, and duplicated or templated metadata is a documented content-quality problem regardless of how original the body copy is
  • H1: exactly one, matches page intent, includes keyword
  • H2-H6: logical hierarchy (no skipped levels), descriptive
  • URL: short, descriptive, hyphenated, no parameters
  • Internal links: sufficient, relevant anchor text, no orphan pages
  • External links: to authoritative sources, reasonable count
Content Quality
  • Word count vs page type minimums (see quality-gates.md)
  • Readability: Flesch Reading Ease score, grade level
  • Keyword density: natural (1-3%), semantic variations present
  • E-E-A-T signals: author bio, credentials, first-hand experience markers
  • Content freshness: publication date, last updated date
Technical Elements
  • Canonical tag: present, self-referencing or correct
  • Meta robots: index/follow unless intentionally blocked
  • Open Graph: og:title, og:description, og:image, og:url
  • Twitter Card: twitter:card, twitter:title, twitter:description
  • Hreflang: if multi-language, correct implementation
Schema Markup
  • Detect all types (JSON-LD preferred)
  • Validate required properties
  • Identify missing opportunities
  • Never recommend HowTo (deprecated) or FAQ for rich results (retired May 2026); existing FAQPage need not be removed, use QAPage for genuine Q&A
Images
  • Alt text: present, descriptive, includes keywords where natural
  • File size: flag >200KB (warning), >500KB (critical)
  • Format: recommend WebP/AVIF over JPEG/PNG
  • Dimensions: width/height set for CLS prevention
  • Lazy loading: report lazy_method per image (native | perfmatters | ewww | js-generic | none). Do not flag "not lazy-loaded" when JS lazy-loaders (Perfmatters, EWWW, lazysizes) are detected, they intentionally strip the native loading="lazy" attribute and use data-src placeholders
Show full SKILL.md (171 more words)Show less
Core Web Vitals (reference only, not measurable from HTML alone)
  • Flag potential LCP issues (huge hero images, render-blocking resources)
  • Flag potential INP issues (heavy JS, no async/defer)
  • Flag potential CLS issues (missing image dimensions, injected content)

Output

Page Score Card
Overall Score: XX/100

On-Page SEO:     XX/100  ████████░░
Content Quality: XX/100  ██████████
Technical:       XX/100  ███████░░░
Schema:          XX/100  █████░░░░░
Images:          XX/100  ████████░░
Issues Found

Organized by priority: Critical -> High -> Medium -> Low

Recommendations

Specific, actionable improvements with expected impact

Schema Suggestions

Ready-to-use JSON-LD code for detected opportunities

DataForSEO Integration (Optional)

If DataForSEO MCP tools are available, use serp_organic_live_advanced for real SERP positions and backlinks_summary for backlink data and spam scores.

Error Handling

ScenarioAction
URL unreachable (DNS failure, connection refused)Report the error clearly. Do not guess page content. Suggest the user verify the URL and try again.
Page requires authentication (401/403)Report that the page is behind authentication. Suggest the user provide the rendered HTML directly or a publicly accessible URL.
JavaScript-rendered content (empty body in HTML)Note that key content may be rendered client-side. Analyze the available HTML and flag that results may be incomplete. Suggest using a browser-rendered snapshot if available.

© 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 in skills/seo-page of AgriciDaniel/claude-seo.

  • SKILL.md
  • LICENSE.txt

Open the folder on GitHubat commit 4b99de2

Compare with similar skills

Single Page SEO Analysis 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.

Single Page SEO Analysis compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Single Page SEO Analysis this skillAgriciDaniel/claude-seo19k—~1.1kAutomated safety check: PassMIT
SEO Optimizerailabs-393/ai-labs-claude-skills4551 repos~3.2kAutomated safety check: PassMIT
Browser4 SEOplatonai/Browser41.2k—~1.6kAutomated safety check: PassApache-2.0
SEO Checkerhanzili/hanzi-browse177—~1.9kAutomated safety check: PassCustom licence
SEO Auditjosstei/maestro-orchestrate465—~218Automated safety check: PassApache-2.0
SEO Audittextura-agency/next16-claude-starter133—~2.2kAutomated safety check: NotesUnlicense

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.

    455 GitHub starsUsed in 1 repo~3.2k tokens
    Marketing & SEOAuto-check passed
  • Browser4 SEO

    platonai/Browser4

    Extract and audit SEO metadata from the current browser page.

    1.2k GitHub stars~1.6k tokensUpdated today
    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
  • SEO Audit

    josstei/maestro-orchestrate

    Run a Maestro-style SEO assessment for meta tags, structured data, crawlability, and Core Web Vitals

    465 GitHub stars~218 tokensUpdated 3 days ago
    Marketing & SEOAuto-check passed
  • SEO Audit

    textura-agency/next16-claude-starter

    Audit a page or the whole site for technical and on-page SEO — crawlability, metadata, heading outline, structured data, internal linking, Core Web Vitals, and the animation-specific crawlability…

    133 GitHub stars~2.2k tokensUpdated 3 days ago
    Marketing & SEOAuto-check: notes
  • SEO Strategy

    cbrock84/headcount

    Audits and improves organic search performance — technical health, site architecture, internal linking, structured data, and the content decisions that determine what can rank.

    2k GitHub stars~1.3k tokensUpdated 22 days 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

Categories

Questions about Single Page SEO Analysis

What does Single Page SEO Analysis do?

Reviews one URL for on-page SEO, content quality, technical metadata, schema, images and performance, using concrete length and size thresholds. The agent checks one page against a fixed list. On-page items include a title of 50 to 60 characters, a meta description of 150 to 160 characters, a single H1, a clean heading hierarchy, a short URL and sensible internal and external links.

When should I use Single Page SEO Analysis?

Single Page SEO Analysis fits situations like: reviewing the SEO of one landing page or blog post; checking title, meta description and heading structure before publishing; validating schema markup and Open Graph tags on a single URL; spotting oversized or poorly lazy-loaded images on a page.

How do I install Single Page SEO Analysis in Claude Code?

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

How do I install Single Page SEO Analysis in Codex?

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

Can I use Single Page SEO Analysis 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-page -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-page, .gemini/skills/seo-page, .github/skills/seo-page and .opencode/skills/seo-page in your project.

What does Single Page SEO Analysis need to run?

SKILL.md names no scripts, command-line tools or credentials: Single Page SEO Analysis is instructions for the agent only. Our summary lists: The claude-seo plugin scripts, for the metadata comparison.

Does Single Page SEO Analysis 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 Single Page SEO Analysis 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 Single Page SEO Analysis use?

Single Page SEO Analysis 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 Single Page SEO Analysis use?

About 1.1k tokens (SKILL.md is roughly 4.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Single Page SEO Analysis?

Skills that share tags, products or a category with Single Page SEO Analysis: SEO Optimizer (ailabs-393/ai-labs-claude-skills, 455 stars), Browser4 SEO (platonai/Browser4, 1.2k stars), SEO Checker (hanzili/hanzi-browse, 177 stars) and SEO Audit (josstei/maestro-orchestrate, 465 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Single Page SEO Analysis?

AgriciDaniel (a GitHub user) maintains it in AgriciDaniel/claude-seo, which has 18,627 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.