Agent skill

Diagnose SEO

by galfrevn in galfrevn/apollo

Structured diagnostic for technical SEO problems. An agent skill from galfrevn/apollo.

MITAuto-check passedMarketing & SEO

Install Diagnose SEO

skills CLI
$ npx skills add galfrevn/apollo --skill diagnose-seo -a claude-code

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

GitHub CLI
$ gh skill install galfrevn/apollo diagnose-seo --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/galfrevn/apollo.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/diagnose-seo .claude/skills/diagnose-seo && 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
diagnose-seo
GitHub stars
237
Token cost
~1.6k tokens
SKILL.md length
783 words
Files
1
Skills in repo
4
Repo updated
First seen
Licence
MIT

At a glance

Structured diagnostic for technical SEO problems. An agent skill from galfrevn/apollo.

  • Works in 4 steps: Crawlability — Can search engines find… → Indexability — Are the pages allowed to… → Renderability — Can search engines see… → …
  • The user asks about crawl issues
  • SKILL.md covers Diagnostic Approach, Layer 1: Crawlability, Layer 2: Indexability and Layer 3: Renderability, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Diagnose SEO is an agent skill from galfrevn/apollo. Structured diagnostic for technical SEO problems. Use when the user asks about crawl issues, indexation problems, why pages aren't being indexed, robots.txt questions, canonical errors, sitemap issues, rendering problems, or general technical SEO troubleshooting. For Core Web Vitals and page speed, see audit-speed.

Its SKILL.md is about 1.6k 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 Technical SEO and Web performance. The repository describes itself as: The open-source brain for physical agentic devices, powered by Cloudflare Workers. The licence is MIT.

When your agent uses it

  • The user asks about crawl issues
  • Indexation problems
  • Why pages arent being indexed
  • Robots.txt questions

Example prompts

  • “/diagnose-seo”

Workflow steps

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

  1. Crawlability — Can search engines find and access the pages?
  2. Indexability — Are the pages allowed to be indexed?
  3. Renderability — Can search engines see the full content?
  4. Signals — Are the right signals (titles, structured data, links) in place?

What it can do on your machine

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

    Links to these hosts (documentation or services it may open):

    • seojuice.com

    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

Diagnose SEO loads about 1.6k tokens when it runs. Until then it costs about 82 tokens; SKILL.md has 783 words of instructions outside code blocks.

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

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 galfrevn/apollo at commit c7605d6, republished under its MIT licence (© galfrevn). 783 words, ~1,572 tokens.

Download SKILL.mdSave it as .claude/skills/diagnose-seo/SKILL.md (or your agent's skills folder).
name
diagnose-seo
description
Structured diagnostic for technical SEO problems. Use when the user asks about crawl issues, indexation problems, why pages aren't being indexed, robots.txt questions, canonical errors, sitemap issues, rendering problems, or general technical SEO troubleshooting. For Core Web Vitals and page speed, see audit-speed.
metadata.version
1.0.0

Diagnose SEO

Structured diagnostic framework for crawl issues, canonicalization errors, indexation problems, and rendering failures.

Diagnostic Approach

Technical SEO problems fall into four categories. Diagnose in this order — each layer depends on the previous one working correctly:

  1. Crawlability — Can search engines find and access the pages?
  2. Indexability — Are the pages allowed to be indexed?
  3. Renderability — Can search engines see the full content?
  4. Signals — Are the right signals (titles, structured data, links) in place?

Layer 1: Crawlability

Check these in order:

robots.txt
  • Fetch [domain]/robots.txt and review the rules
  • Look for overly broad Disallow rules blocking important paths
  • Verify Sitemap: directive points to the correct sitemap URL
  • Check for different rules per user-agent (Googlebot vs others)

Common mistakes:

  • Disallow: / blocking the entire site (often left from staging)
  • Blocking CSS/JS files that Googlebot needs for rendering
  • Blocking API or AJAX endpoints that load dynamic content
  • Staging robots.txt accidentally deployed to production
XML Sitemap
  • Fetch the sitemap URL(s) and check:
    • Does it return 200? Is it valid XML?
    • Does it list all important pages?
    • Does it exclude pages that shouldn't be indexed (404s, redirects, noindex pages)?
    • Are <lastmod> dates accurate and recent?
    • For large sites: is there a sitemap index?
Site Architecture
  • Pages should be reachable within 3 clicks from the homepage
  • Check for orphan pages (no internal links pointing to them)
  • Check for redirect chains (page A → B → C — should be A → C)
  • Check for redirect loops
Server Response
  • Do all important pages return HTTP 200?
  • Check for unexpected 301/302 redirects
  • Check for soft 404s (page returns 200 but shows "not found" content)
  • Verify HTTPS is enforced (HTTP should 301 to HTTPS)

Layer 2: Indexability

Meta Robots / X-Robots-Tag
  • Check for <meta name="robots" content="noindex"> on pages that should be indexed
  • Check HTTP headers for X-Robots-Tag: noindex
  • Common cause: CMS accidentally applying noindex to pagination, tag pages, or new pages
Canonical Tags
  • Every page should have a <link rel="canonical"> pointing to itself (self-referencing canonical)
  • Check for canonical tags pointing to wrong pages (common in paginated content, filtered URLs)
  • Check for conflicting signals: canonical says page A, but noindex is set, or the page redirects

Canonical diagnosis checklist:

  • Does the canonical URL match the actual URL?
  • Is the canonical URL accessible (returns 200)?
  • Does the canonical URL have the same content?
  • Is there only one canonical tag on the page?
Duplicate Content
  • Check for the same content accessible at multiple URLs:
    • With and without trailing slash (/page vs /page/)
    • With and without www (example.com vs www.example.com)
    • HTTP vs HTTPS
    • URL parameters creating duplicate pages (?sort=price, ?page=1)
  • Each duplicate set needs one canonical URL; all others should redirect or use canonical tags

Layer 3: Renderability

JavaScript Rendering
  • Does the page content appear in the raw HTML source? Or is it loaded via JavaScript?
  • If JS-rendered: does Googlebot see the full content? (Use URL Inspection tool in Search Console)
  • Check for content hidden behind click events, tabs, or accordions
  • Check for lazy-loaded content that only appears on scroll
Show full SKILL.md (289 more words)Show less
Core Content Visibility
  • Is the main content in the initial HTML? Or loaded async after page load?
  • Are important elements (titles, headings, product details) in the DOM on first render?
  • Check for content that requires login or cookies to view

Layer 4: Signals

Title Tags
  • Every page has a unique <title>
  • Title includes the primary keyword
  • Under 60 characters (to avoid truncation in SERPs)
  • Descriptive and click-worthy
Meta Descriptions
  • Every important page has a meta description
  • 150-160 characters
  • Includes target keyword and a value proposition
  • Unique per page
Heading Structure
  • One H1 per page containing the primary keyword
  • Logical heading hierarchy (H1 → H2 → H3, no skips)
  • Headings describe section content (not decorative)
Structured Data
  • Check for JSON-LD structured data appropriate to the page type
  • Validate with Google's Rich Results Test
  • Common types: Article, Product, FAQ, HowTo, BreadcrumbList, Organization
Hreflang (multilingual sites)
  • Check for correct hreflang tags linking language variants
  • Verify reciprocal tags (page A points to B, B points back to A)
  • Check for x-default tag

Output Format

Technical SEO Diagnosis: [domain]

Summary

  • Critical issues: [count]
  • Warnings: [count]
  • Passed checks: [count]

Findings by Layer

For each issue found:

LayerIssueSeverityAffected PagesFix
Crawlabilityrobots.txt blocks /blog/CriticalAll blog pagesRemove Disallow: /blog/ from robots.txt
IndexabilityMissing canonical tagsWarning15 pagesAdd self-referencing canonicals
...............

Priority Fix List

Ordered by impact:

  1. [Critical fix] — affects [n] pages, blocks [crawling/indexing/ranking]
  2. [Warning fix] — affects [n] pages, reduces [signal quality]
  3. ...

Pro Tip: Run the free SEO Audit for a quick technical check, the Broken Link Checker to find dead links, and the Robots.txt Generator to fix crawl directives. SEOJuice MCP users can run /seojuice:site-health for a full technical report and /seojuice:page-audit [domain] [url] to drill into specific pages.

© galfrevn, 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/diagnose-seo of galfrevn/apollo.

Open the folder on GitHubat commit c7605d6

Compare with similar skills

Diagnose SEO 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.

Diagnose SEO compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Diagnose SEO this skillgalfrevn/apollo237—~1.6kAutomated safety check: PassMIT
Google SEO APIsAgriciDaniel/claude-seo19k1 repos~4.2kAutomated safety check: PassMIT
SEOAgriciDaniel/seo-os1372 repos~3.5kAutomated safety check: PassMIT
SEO Coachakseolabs-seo/seo-coach146—~2.8kAutomated safety check: PassNone
SEO Googleseranking/seo-skills161—~4.8kAutomated safety check: PassMIT
SEOAgriciDaniel/codex-seo799—~3.7kAutomated safety check: PassMIT

Similar skills

  • 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
    Marketing & SEOAuto-check passed
  • SEO

    AgriciDaniel/seo-os

    Comprehensive SEO analysis for any website or business type.

    137 GitHub starsUsed in 2 repos~3.5k 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
  • SEO Google

    seranking/seo-skills

    Direct access to Google's own SEO data via Search Console (Search Analytics, URL Inspection, Sitemaps), PageSpeed Insights v5, CrUX field data with 25-week history, Indexing API v3, GA4 organic…

    161 GitHub stars~4.8k tokensUpdated 3 mo ago
    Marketing & SEOAuto-check passed
  • SEO

    AgriciDaniel/codex-seo

    Comprehensive SEO analysis for any website, page, business, or topic.

    799 GitHub stars~3.7k tokensUpdated 29 days ago
    Marketing & SEOAuto-check passed
  • SEO Audit

    unifapi-agent/agents

    When the user wants to audit, review, or diagnose SEO issues on their site.

    589 GitHub stars~3.4k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed

More from galfrevn/apollo

  • Bun

    galfrevn/apollo

    A skill your agent uses when building, running, testing, or bundling JavaScript/TypeScript applications.

    237 GitHub stars~2k tokensUpdated 1 mo ago
    Auto-check: notes
  • Greploop

    galfrevn/apollo

    Runs the Greptile CLI on the current local branch, fixes what the review finds, and reviews again, until the review comes back 5/5 with zero comments.

    237 GitHub stars~2k tokensUpdated 1 mo ago
    Auto-check: notes
  • Optimize For AI

    galfrevn/apollo

    Optimize content for AI search engines — ChatGPT, Perplexity, Claude, Gemini, Google AI Overviews.

    237 GitHub stars~4.3k tokensUpdated 1 mo ago
    Auto-check passed

Categories

Questions about Diagnose SEO

What does Diagnose SEO do?

Structured diagnostic for technical SEO problems. An agent skill from galfrevn/apollo. Diagnose SEO is an agent skill from galfrevn/apollo. Structured diagnostic for technical SEO problems.

When should I use Diagnose SEO?

Diagnose SEO fits situations like: the user asks about crawl issues; indexation problems; why pages arent being indexed; robots.txt questions.

How do I install Diagnose SEO in Claude Code?

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

How do I install Diagnose SEO in Codex?

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

Can I use Diagnose SEO 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 galfrevn/apollo --skill diagnose-seo -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/diagnose-seo, .gemini/skills/diagnose-seo, .github/skills/diagnose-seo and .opencode/skills/diagnose-seo in your project.

What does Diagnose SEO need to run?

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

Does Diagnose SEO access the network?

SKILL.md names 1 domain. As links in the text: seojuice.com. This is read from the text; nothing was executed.

Is Diagnose SEO 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 Diagnose SEO use?

Diagnose SEO 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 Diagnose SEO use?

About 1.6k tokens (SKILL.md is roughly 6.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 Diagnose SEO?

Skills that share tags, products or a category with Diagnose SEO: Google SEO APIs (AgriciDaniel/claude-seo, 19k stars), SEO (AgriciDaniel/seo-os, 137 stars), SEO Coach (akseolabs-seo/seo-coach, 146 stars) and SEO Google (seranking/seo-skills, 161 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Diagnose SEO?

galfrevn (a GitHub user) maintains it in galfrevn/apollo, which has 237 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on August 17, 2026.

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