Agent skill

SEO Audit

by andrew-yangy in andrew-yangy/gru-ai

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

MITAuto-check passedMarketing & SEO

Install SEO Audit

skills CLI
$ npx skills add andrew-yangy/gru-ai --skill seo-audit -a claude-code

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

GitHub CLI
$ gh skill install andrew-yangy/gru-ai 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/andrew-yangy/gru-ai.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/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
155
Token cost
~731 tokens
SKILL.md length
270 words
Files
1
Skills in repo
9
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 6 steps: Fetch homepage — use… → Detect business type — analyze homepage… → Crawl site — follow internal links up to… → …
  • User says audit
  • SKILL.md covers Process, Crawl Configuration, Output Files and Scoring Weights, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

SEO Audit is an agent skill from andrew-yangy/gru-ai. Full website SEO audit with parallel subagent delegation. Crawls up to 500 pages, detects business type, delegates to 6 specialists, generates health score. Use when user says "audit", "full SEO check", "analyze my site", or "website health check".

Its SKILL.md is about 730 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, On-page SEO and Technical SEO. The repository describes itself as: Autonomous AI agent team for one-man companies. Context engineering + harness engineering drive a pipeline that brainstorms, builds, reviews, and ships. The licence is MIT.

When your agent uses it

  • User says audit
  • Analyze my site
  • Website health check

Example prompts

  • “full SEO check”
  • “analyze my site”
  • “website health check”
  • “/seo-audit”

Workflow steps

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

  1. Fetch homepage — use scripts/fetch_page.py to retrieve HTML
  2. Detect business type — analyze homepage signals per seo orchestrator
  3. Crawl site — follow internal links up to 500 pages, respect robots.txt
  4. Delegate to subagents (if available, otherwise run inline sequentially)
  5. Score — aggregate into SEO Health Score (0-100)
  6. Report — generate prioritized action plan

What it can do on your machine

Read from SKILL.md and the folder at commit 8fba479. 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 731 tokens when it runs. Until then it costs about 65 tokens; SKILL.md has 270 words of instructions outside code blocks.

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

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 andrew-yangy/gru-ai at commit 8fba479, republished under its MIT licence (© andrew-yangy). 270 words, ~731 tokens.

Download SKILL.mdSave it as .claude/skills/seo-audit/SKILL.md (or your agent's skills folder).
name
seo-audit
description
Full website SEO audit with parallel subagent delegation. Crawls up to 500 pages, detects business type, delegates to 6 specialists, generates health score. Use when user says "audit", "full SEO check", "analyze my site", or "website health check".

Full Website SEO Audit

Process

  1. Fetch homepage — use scripts/fetch_page.py to retrieve HTML
  2. Detect business type — analyze homepage signals per seo orchestrator
  3. Crawl site — follow internal links up to 500 pages, respect robots.txt
  4. Delegate to subagents (if available, otherwise run inline sequentially):
    • seo-technical — robots.txt, sitemaps, canonicals, Core Web Vitals, security headers
    • seo-content — E-E-A-T, readability, thin content, AI citation readiness
    • seo-schema — detection, validation, generation recommendations
    • seo-sitemap — structure analysis, quality gates, missing pages
    • seo-performance — LCP, INP, CLS measurements
    • seo-visual — screenshots, mobile testing, above-fold analysis
  5. Score — aggregate into SEO Health Score (0-100)
  6. Report — generate prioritized action plan

Crawl Configuration

Max pages: 500
Respect robots.txt: Yes
Follow redirects: Yes (max 3 hops)
Timeout per page: 30 seconds
Concurrent requests: 5
Delay between requests: 1 second

Output Files

  • FULL-AUDIT-REPORT.md — Comprehensive findings
  • ACTION-PLAN.md — Prioritized recommendations (Critical → High → Medium → Low)
  • screenshots/ — Desktop + mobile captures (if Playwright available)

Scoring Weights

CategoryWeight
Technical SEO25%
Content Quality25%
On-Page SEO20%
Schema / Structured Data10%
Performance (CWV)10%
Images5%
AI Search Readiness5%

Report Structure

Executive Summary
  • Overall SEO Health Score (0-100)
  • Business type detected
  • Top 5 critical issues
  • Top 5 quick wins
Technical SEO
  • Crawlability issues
  • Indexability problems
  • Security concerns
  • Core Web Vitals status
Content Quality
  • E-E-A-T assessment
  • Thin content pages
  • Duplicate content issues
  • Readability scores
On-Page SEO
  • Title tag issues
  • Meta description problems
  • Heading structure
  • Internal linking gaps
Schema & Structured Data
  • Current implementation
  • Validation errors
  • Missing opportunities
Performance
  • LCP, INP, CLS scores
  • Resource optimization needs
  • Third-party script impact
Images
  • Missing alt text
  • Oversized images
  • Format recommendations
AI Search Readiness
  • Citability score
  • Structural improvements
  • Authority signals

Priority Definitions

  • Critical: Blocks indexing or causes penalties (fix immediately)
  • High: Significantly impacts rankings (fix within 1 week)
  • Medium: Optimization opportunity (fix within 1 month)
  • Low: Nice to have (backlog)

© andrew-yangy, 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 .claude/skills/seo-audit of andrew-yangy/gru-ai.

Open the folder on GitHubat commit 8fba479

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 skillandrew-yangy/gru-ai155—~731Automated safety check: PassMIT
SEO AuditAgriciDaniel/codex-seo7992 repos~1.9kAutomated safety check: PassMIT
SEO Optimizerailabs-393/ai-labs-claude-skills4551 repos~3.2kAutomated safety check: PassMIT
SEO Drift MonitorAgriciDaniel/claude-seo19k1 repos~1.9kAutomated safety check: PassMIT
SEO Coachakseolabs-seo/seo-coach146—~2.8kAutomated safety check: PassNone
Universal SEO AnalysisAgriciDaniel/claude-seo19k—~4.9kAutomated safety check: PassMIT

Similar skills

  • SEO Audit

    AgriciDaniel/codex-seo

    Full website SEO audit with parallel subagent delegation. An agent skill from AgriciDaniel/codex-seo.

    799 GitHub starsUsed in 2 repos~1.9k tokens
    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
  • SEO Drift Monitor

    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.

    19k GitHub starsUsed in 1 repo~1.9k tokens
    Marketing & SEOAuto-check passed
  • SEO Coach

    akseolabs-seo/seo-coach

    Beginner-first SEO coaching for people who want to learn by doing one safe, verifiable step at a time.

    146 GitHub stars~2.8k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • Universal SEO Analysis

    AgriciDaniel/claude-seo

    Hub for site-wide SEO work: audits, technical checks, schema, content quality, local, hreflang and AI-search readiness, run through slash commands.

    19k GitHub stars~4.9k tokensUpdated 6 days ago
    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.

    4.1k GitHub stars~1.9k tokensUpdated 17 days ago
    Marketing & SEOAuto-check passed

More from andrew-yangy/gru-ai

All 9 skills in this repo
  • Code Review Excellence

    andrew-yangy/gru-ai

    Provides comprehensive code review guidance for React 19, Vue 3, Rust, TypeScript, Java, Python, and C/C++.

    155 GitHub stars~1.7k tokensUpdated 7 mo ago
    Auto-check: notes
  • Brainstorm

    andrew-yangy/gru-ai

    Structured brainstorm — from quick Socratic refinement to full C-suite strategy sessions.

    155 GitHub stars~3.2k tokensUpdated 7 mo ago
    Auto-check passed
  • Healthcheck

    andrew-yangy/gru-ai

    Internal codebase and operations health check — the CTO scans technical health, the COO checks operational health.

    155 GitHub stars~2.4k tokensUpdated 7 mo ago
    Auto-check passed
  • Report

    andrew-yangy/gru-ai

    CEO dashboard with progressive disclosure — 3 tiers: headline (5 lines, default), summary (per-goal detail), deep (full weekly analysis).

    155 GitHub stars~4k tokensUpdated 7 mo ago
    Auto-check passed
  • Smoke Test

    andrew-yangy/gru-ai

    Pipeline end-to-end smoke test -- creates a trivial directive, runs it through /directive, validates every pipeline step, and reports pass/fail with evidence.

    155 GitHub stars~941 tokensUpdated 7 mo ago
    Auto-check passed
  • Directive

    andrew-yangy/gru-ai

    Execute work through the directive pipeline — evaluate, plan, cast agents, build, review, and report.

    155 GitHub stars~2.8k tokensUpdated 7 mo ago
    Auto-check: warnings

Categories

Questions about SEO Audit

What does SEO Audit do?

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

When should I use SEO Audit?

SEO Audit fits situations like: user says audit; analyze my site; website health check.

How do I install SEO Audit in Claude Code?

Run `npx skills add andrew-yangy/gru-ai --skill seo-audit -a claude-code`. Or copy the skill folder (.claude/skills/seo-audit in andrew-yangy/gru-ai) 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 andrew-yangy/gru-ai --skill seo-audit -a codex`. Or copy the skill folder (.claude/skills/seo-audit in andrew-yangy/gru-ai) 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 andrew-yangy/gru-ai --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 731 tokens (SKILL.md is roughly 2.9k 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 Audit (AgriciDaniel/codex-seo, 799 stars), SEO Optimizer (ailabs-393/ai-labs-claude-skills, 455 stars), SEO Drift Monitor (AgriciDaniel/claude-seo, 19k stars) and SEO Coach (akseolabs-seo/seo-coach, 146 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains SEO Audit?

andrew-yangy (a GitHub user) maintains it in andrew-yangy/gru-ai, which has 155 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on March 11, 2026.

Source: andrew-yangy/gru-ai on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.