Agent skill

SEO Audit

by shadcn-labs in shadcn-labs/agentcn

How to present the deterministic AI-SEO audit returned by auditpage.

MITAuto-check passedMarketing & SEO

Install SEO Audit

skills CLI
$ npx skills add shadcn-labs/agentcn --skill seo-audit -a claude-code

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

GitHub CLI
$ gh skill install shadcn-labs/agentcn seo-audit --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/shadcn-labs/agentcn.git skills-src && mkdir -p .claude/skills && cp -r skills-src/registry/flue/ai-seo-audit/skills/seo-audit .claude/skills/seo-audit && 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-audit
GitHub stars
490
Token cost
~598 tokens
SKILL.md length
265 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
MIT

At a glance

How to present the deterministic AI-SEO audit returned by auditpage.

  • Works in 4 steps: The overall score/100, its band.label,… → A per-category breakdown: for each… → The failing and partial checks,… → …
  • Reporting a pages readability and citation-readiness for AI answer engines (ChatGPT
  • SKILL.md covers What this measures, The result shape, The six categories and Output
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

SEO Audit is an agent skill from shadcn-labs/agentcn. How to present the deterministic AI-SEO audit returned by auditpage. Use when reporting a page's readability and citation-readiness for AI answer engines (ChatGPT, Claude, Perplexity).

Its SKILL.md is about 600 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Marketing & SEO, covering SEO audit, AI search optimization and Plain language and style rules. It works with OpenAI and Perplexity. The repository describes itself as: shadcn/ui, but for building agents. 🤖. The licence is MIT.

When your agent uses it

  • Reporting a pages readability and citation-readiness for AI answer engines (ChatGPT
  • Tasks that involve SEO audit
  • Tasks that involve AI search optimization

Example prompts

  • “/seo-audit”

Workflow steps

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

  1. The overall score/100, its band.label, and the band.interpretation.
  2. A per-category breakdown: for each category, score/maxScore and the
  3. The failing and partial checks, highest-impact first — use topPriorities
  4. The agent-ready fix prompt: present agentPrompts.full verbatim in a

What it can do on your machine

Read from SKILL.md and the folder at commit 4cd4d83. 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

SEO Audit loads about 598 tokens when it runs. Until then it costs about 49 tokens; SKILL.md has 265 words of instructions outside code blocks.

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

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 shadcn-labs/agentcn at commit 4cd4d83, republished under its MIT licence (© shadcn-labs). 265 words, ~598 tokens.

Download SKILL.mdSave it as .claude/skills/seo-audit/SKILL.md (or your agent's skills folder).
name
seo-audit
description
How to present the deterministic AI-SEO audit returned by audit_page. Use when reporting a page's readability and citation-readiness for AI answer engines (ChatGPT, Claude, Perplexity).

What this measures

How well a page can be crawled, chunked, understood, and cited by AI answer engines — not classic blue-link SEO. The audit_page tool computes this deterministically: page data flows through context.dev, then a fixed rubric of ~30 checks scores six categories into a 0–100 total. Your job is to present that result, not to re-score it.

The result shape

audit_page returns JSON with:

  • score (0–100) and band ({ label, interpretation }).
  • stats — words, headings, links, externalLinks, jsonLdBlocks, char counts.
  • categories[] — each { id, name, score, maxScore, naExcluded, items[] }.
  • categories[].items[] — each check: { id, label, status, evidence, recommendation, score, maxScore }. status is pass | partial | fail | na.
  • topPriorities[] — the highest-impact failing/partial checks, pre-sorted.
  • agentPrompts — { full, topIssues[] }, ready-to-run fix prompts.
  • diagnostics — context.dev fetch status and JSON-LD parse failures.

The six categories

IDCategoryMax
ATechnical AI Crawlability28.4
BContent Structure & Chunking25.4
CStructured Data / Schema13.4
DE-E-A-T & Entity Authority21.4
EOff-site / Citation Surface Presence8.4
FMeasurement & Governance3

Scoring (already applied by the tool): pass = full weight, partial = half, fail = 0, na = excluded from the denominator. Bands: Critical ≤40 · Below average ≤55 · Average ≤70 · Strong ≤85 · Excellent >85.

Output

Report, in order:

  1. The overall score/100, its band.label, and the band.interpretation.
  2. A per-category breakdown: for each category, score/maxScore and the pass/partial/fail counts.
  3. The failing and partial checks, highest-impact first — use topPriorities and the matching items (cite each check's id, evidence, and recommendation).
  4. The agent-ready fix prompt: present agentPrompts.full verbatim in a copy-paste block.

Report only the checks and numbers the tool returned. Never invent or recompute scores, checks, evidence, or content.

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

Files

Just SKILL.md in registry/flue/ai-seo-audit/skills/seo-audit of shadcn-labs/agentcn.

Open the folder on GitHubat commit 4cd4d83

Compare with similar skills

SEO Audit 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 Audit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
SEO Audit this skillshadcn-labs/agentcn490—~598Automated safety check: PassMIT
SEO ProfoundAgriciDaniel/claude-seo19k1 repos~441Automated safety check: PassMIT
Suede SEO AuditJasonColapietro/suede-creator-skills127—~5.5kAutomated safety check: PassMIT
AI Search Visibility Auditdavepoon/buildwithclaude3.6k—~2.4kAutomated safety check: PassMIT
Money SEOiamzifei/show-me-the-money1k—~4.4kAutomated safety check: PassCustom licence
Geo Fundamentalswasp-lang/wasp19k9 repos~861Automated safety check: PassMIT

Similar skills

  • SEO Profound

    AgriciDaniel/claude-seo

    Profound LLM citation tracker (extension). An agent skill from AgriciDaniel/claude-seo.

    19k GitHub starsUsed in 1 repo~441 tokens
    Marketing & SEOAuto-check passed
  • Suede SEO Audit

    JasonColapietro/suede-creator-skills

    Suede-owned SEO and generative-search audit discipline. An agent skill from JasonColapietro/suede-creator-skills.

    127 GitHub stars~5.5k tokensUpdated yesterday
    Marketing & SEOAuto-check passed
  • AI Search Visibility Audit

    davepoon/buildwithclaude

    Audit whether a website can be found, crawled, and cited by AI answer engines such as ChatGPT Search, Perplexity, Google AI Overviews, and Microsoft Copilot.

    3.6k GitHub stars~2.4k tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed
  • Money SEO

    iamzifei/show-me-the-money

    SEO and GEO (Generative Engine Optimization) for organic traffic and AI search visibility.

    1k GitHub stars~4.4k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • Geo Fundamentals

    wasp-lang/wasp

    Generative Engine Optimization for AI search engines (ChatGPT, Claude, Perplexity).

    19k GitHub starsUsed in 9 repos~861 tokens
    Marketing & SEOAuto-check passed
  • GEO-First SEO Audit Tool

    zubair-trabzada/geo-seo-claude

    Audits a website for AI search visibility across ChatGPT, Claude, Perplexity and Google AI Overviews while checking traditional SEO, schema and E-E-A-T content quality.

    11k GitHub stars~2.8k tokensUpdated yesterday
    Marketing & SEOAuto-check: notes

More from shadcn-labs/agentcn

  • Mastra File Agents

    shadcn-labs/agentcn

    Migrate Mastra code-based agents (agents built with new Agent(...) and registered in a Mastra({ agents }) map) to the file-based convention: one directory per agent under src/mastra/agents.

    490 GitHub stars~2.4k tokensUpdated 4 days ago
    Auto-check passed
  • Flue

    shadcn-labs/agentcn

    A skill your agent uses when building, debugging, reviewing, or documenting Flue agents, workflows, channels, skills, tools, sandboxes, targets, routing, persistence, observability, or CLI usage…

    490 GitHub stars~2k tokensUpdated 4 days ago
    Auto-check passed
  • Research

    shadcn-labs/agentcn

    Iterative, self-evaluating web research. An agent skill from shadcn-labs/agentcn.

    490 GitHub stars~133 tokensUpdated 4 days ago
    Auto-check passed
  • Workspace

    shadcn-labs/agentcn

    How to safely operate the sandboxed workspace. An agent skill from shadcn-labs/agentcn.

    490 GitHub stars~141 tokensUpdated 4 days ago
    Auto-check passed

Categories

Questions about SEO Audit

What does SEO Audit do?

How to present the deterministic AI-SEO audit returned by auditpage. SEO Audit is an agent skill from shadcn-labs/agentcn. How to present the deterministic AI-SEO audit returned by auditpage.

When should I use SEO Audit?

SEO Audit fits situations like: reporting a pages readability and citation-readiness for AI answer engines (ChatGPT; tasks that involve SEO audit; tasks that involve AI search optimization.

How do I install SEO Audit in Claude Code?

Run `npx skills add shadcn-labs/agentcn --skill seo-audit -a claude-code`. Or copy the skill folder (registry/flue/ai-seo-audit/skills/seo-audit in shadcn-labs/agentcn) into .claude/skills/seo-audit in your project. Claude Code loads it when a task matches its description.

How do I install SEO Audit in Codex?

Run `npx skills add shadcn-labs/agentcn --skill seo-audit -a codex`. Or copy the skill folder (registry/flue/ai-seo-audit/skills/seo-audit in shadcn-labs/agentcn) into .agents/skills/seo-audit in your project. Codex loads it when a task matches its description.

Can I use SEO Audit 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 shadcn-labs/agentcn --skill seo-audit -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-audit, .gemini/skills/seo-audit, .github/skills/seo-audit and .opencode/skills/seo-audit in your project.

What does SEO Audit need to run?

SKILL.md names no scripts, command-line tools or credentials: SEO Audit is instructions for the agent only.

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

SEO Audit is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does SEO Audit use?

About 598 tokens (SKILL.md is roughly 2.4k 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 SEO Audit?

Skills that share tags, products or a category with SEO Audit: SEO Profound (AgriciDaniel/claude-seo, 19k stars), Suede SEO Audit (JasonColapietro/suede-creator-skills, 127 stars), AI Search Visibility Audit (davepoon/buildwithclaude, 3.6k stars) and Money SEO (iamzifei/show-me-the-money, 1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains SEO Audit?

shadcn-labs (a GitHub organization) maintains it in shadcn-labs/agentcn, which has 490 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 7, 2026.

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