diagnose-seo

diagnose-seo is a skill for Claude Code, Codex from calm-north/seojuice-skills. It costs 63 tokens per session (1,486 once invoked), scanned A, original, MIT.

A step-by-step method for finding technical problems that stop search engines from discovering, reading, or listing website pages.

In plain words
What is it for?
It helps investigate robots.txt, XML sitemaps, canonical URLs, pages missing from search results, and content that search engines cannot render.
Why use it?
It separates crawl access, permission to index, page rendering, and search signals, making it easier to find the actual cause instead of guessing.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit It helps investigate robots.txt, XML sitemaps, canonical URLs, pages missing from search results, and content that search engines cannot render.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/calm-north/seojuice-skills/diagnose-seo
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add calm-north/seojuice-skills --skill diagnose-seo
Clone the repo
git clone --depth 1 https://github.com/calm-north/seojuice-skills

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for diagnose-seo

README.md
[![agentmods](https://agentmods.dev/badge/skills/calm-north/seojuice-skills/diagnose-seo/github.svg)](https://agentmods.dev/skills/calm-north/seojuice-skills/diagnose-seo)
Your own site
<a href="https://agentmods.dev/skills/calm-north/seojuice-skills/diagnose-seo"><img src="https://agentmods.dev/badge/skills/calm-north/seojuice-skills/diagnose-seo/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for diagnose-seo

Your own site · 80×15
<a href="https://agentmods.dev/skills/calm-north/seojuice-skills/diagnose-seo"><img src="https://agentmods.dev/badge/skills/calm-north/seojuice-skills/diagnose-seo.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 63 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,486 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • Socket pass 18 Mar 2026
  • Snyk warn 27 Feb 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00063 $0.01486
Opus 5 $0.00032 $0.00743
Sonnet 5 $0.00013 $0.00297
Haiku 4.5 $0.00006 $0.00149

Measured 12d ago against content hash da64c46278f3, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

diagnose-seo scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/diagnose-seo/SKILL.md · 165 lines

How it starts

The opening of the file, as written. The whole thing — 165 lines — stays where its author put it; the contents beside it link to each section on GitHub.

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

Read the full file on GitHub · 165 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 12d ago First seen · 165 lines · 63 tokens per session scan A da64c46278f3

Subscribe to this mod's changes

diagnose-seo is a skill published in the GitHub repository calm-north/seojuice-skills (21 stars, last pushed 6mo ago), licensed MIT. It adds 63 tokens to every session and 1,486 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

content-amplifier

Use when the user asks to "amplify influencer content with paid media", "set up whitelisting or Spark Ads", "decide which posts to boost", "repurpose influencer content", "turn one video into multiple ads", or "build a UGC asset library"; produces (paid mode) a content-selection scorecard, a paid amplification…

aaron-he-zhu/aaron-marketing-skills · 202 tokens

cold-outbound-sequencer

Use when the user asks to "build a B2B cold-outbound sequence", "design reply-triage branching", "plan a domain warmup / sending throttle", or "make my outbound CAN-SPAM / opt-in compliant"; produces a multi-step outbound sequence with reply-triage branches (positive / objection / referral / not-now / opt-out), a…

aaron-he-zhu/aaron-marketing-skills · 172 tokens

inbox-placement-monitor

Use when the user asks to "track where my emails are actually landing after I send", "read my seed-list inbox vs spam vs promotions results", "trend my Gmail Postmaster / Microsoft SNDS reputation", or "did placement drop after my last send"; produces a per-provider inbox/spam/promotions placement read, a domain/IP…

aaron-he-zhu/aaron-marketing-skills · 166 tokens

email-creative-builder

Use when the user asks to "write the email", "draft subject lines", or "build email creative"; produces the pre-click unit — subject-line variants + preheader, body copy, one clear CTA, and a plain-text alt — message-matched to the destination page and claims-ledger-aware. Not for pre-scoring or ranking subject-line…

aaron-he-zhu/aaron-marketing-skills · 149 tokens

newsletter-monetization-planner

Use when the user asks to "monetize my newsletter", "build a sponsorship rate card", or "model paid-subscription revenue"; produces a revenue model (paid tiers, ad/sponsorship inventory + CPM/flat rate card, referral/boost loops), a list-growth ↔ revenue projection, and honest-offer / disclosure checks for the SEND-D…

aaron-he-zhu/aaron-marketing-skills · 139 tokens

contract-helper

Use when the user asks to "draft an influencer contract", "review these agreement terms", or "build a partnership template"; produces a full influencer agreement framework (scope, compensation, usage rights, exclusivity, FTC disclosure), a clause-by-clause review with red flags, and a negotiation cheat sheet. Not for…

aaron-he-zhu/aaron-marketing-skills · 87 tokens