Agent skill

SEO Technical

by rampstackco in rampstackco/claude-skills

Run a comprehensive technical SEO audit covering crawlability, indexability, rendering, site architecture, structured data, page experience, security, and internationalization.

MITAuto-check passedMarketing & SEO

Install SEO Technical

skills CLI
$ npx skills add rampstackco/claude-skills --skill seo-technical -a claude-code

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

GitHub CLI
$ gh skill install rampstackco/claude-skills seo-technical --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/rampstackco/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/seo-technical .claude/skills/seo-technical && 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-technical
GitHub stars
935
Token cost
~1.8k tokens
SKILL.md length
878 words
Files
4 (incl. references)
Skills in repo
103
Repo updated
First seen
Licence
MIT

At a glance

Run a comprehensive technical SEO audit covering crawlability, indexability, rendering, site architecture, structured data, page experience, security, and internationalization.

  • Works in 6 steps: Crawlability → Indexability → Rendering → …
  • The user asks about technical SEO
  • SKILL.md covers When to use, When NOT to use, Required inputs and The framework: 6 layers, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

SEO Technical is an agent skill from rampstackco/claude-skills. Run a comprehensive technical SEO audit covering crawlability, indexability, rendering, site architecture, structured data, page experience, security, and internationalization. Use this skill whenever the user asks about technical SEO, crawl issues, indexing problems, sitemaps, robots.txt, canonical tags, schema markup, page speed, Core Web Vitals, hreflang, redirects, or site-wide search performance. Triggers on technical SEO, site audit, crawlability, indexability, sitemap, robots.txt, canonical, redirect…

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `README.md`, `references/audit-template.md` and `references/migration-checklist.md`).

It sits in Marketing & SEO, covering Technical SEO and Schema markup. It works with JavaScript. The repository describes itself as: Stack-agnostic Claude Skills covering the full website lifecycle: brand, design, content, SEO, dev, ops, growth, and research. Build, ship, audit, optimize. The licence is MIT.

When your agent uses it

  • The user asks about technical SEO
  • Indexing problems
  • Core Web Vitals
  • Site-wide search performance

Example prompts

  • “technical SEO”
  • “/seo-technical”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Crawlability
  2. Indexability
  3. Rendering
  4. Site architecture
  5. Structured data and signals
  6. Page experience and security

What it can do on your machine

Read from SKILL.md and the folder at commit 482c9bf. 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 Technical loads about 1.8k tokens when it runs, and up to ~5.6k if it reads all its reference files. Until then it costs about 200 tokens; SKILL.md has 878 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~200
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.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 rampstackco/claude-skills at commit 482c9bf, republished under its MIT licence (© rampstackco). 878 words, ~1,841 tokens.

Download SKILL.mdSave it as .claude/skills/seo-technical/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
seo-technical
description
Run a comprehensive technical SEO audit covering crawlability, indexability, rendering, site architecture, structured data, page experience, security, and internationalization. Use this skill whenever the user asks about technical SEO, crawl issues, indexing problems, sitemaps, robots.txt, canonical tags, schema markup, page speed, Core Web Vitals, hreflang, redirects, or site-wide search performance. Triggers on technical SEO, site audit, crawlability, indexability, sitemap, robots.txt, canonical, redirect chain, schema, JSON-LD, Core Web Vitals, page speed, hreflang, mobile usability, HTTPS, security headers, render-blocking, JavaScript SEO. Also triggers when a site has indexing problems, traffic drops, or migration concerns, even if 'technical SEO' is not said explicitly.
category
seo-foundation
catalog_summary
Crawlability, indexability, rendering, schema, page experience
display_order
2

Technical SEO

Audit and fix the layer beneath the content: how search engines crawl, render, index, and trust a site. Stack-agnostic.


When to use

  • Site-wide audit before or after a migration
  • Investigating indexing or ranking drops
  • Setting up SEO foundations on a new site
  • Auditing Core Web Vitals or page experience signals
  • Fixing crawl waste, redirect chains, or canonical issues
  • Setting up multilingual or multi-regional sites

When NOT to use

  • Single-page on-page optimization (use seo-onpage)
  • Keyword strategy or content planning (use seo-keyword)
  • Competitor backlink or SERP analysis (use seo-competitor)
  • Pure performance optimization without SEO context (use performance-optimization)

Required inputs

  • The site URL or staging URL
  • Access to (at minimum) view the rendered HTML, robots.txt, and sitemap
  • Ideally: search console access, server logs, and a crawler

If the site is large (10K+ URLs), confirm whether the audit is a full crawl or a sample.


The framework: 6 layers

Technical SEO has six layers, stacked. A failure in a lower layer breaks everything above it.

1. Crawlability

Can search engines access the URLs?

  • robots.txt does not block important paths
  • No accidental noindex on indexable pages
  • No accidental disallow patterns blocking CSS or JS (rendering breaks)
  • Sitemap is present, returns 200, and lists canonical URLs only
  • Sitemap is referenced in robots.txt
  • No infinite spaces (faceted nav generating endless URLs)
  • Crawl budget is not wasted on low-value URLs
2. Indexability

Of crawlable URLs, which should be indexed?

  • One canonical URL per piece of content (no duplicates)
  • Canonical tags self-reference on canonical pages
  • noindex on staging, search results, filter pages, thank-you pages, internal admin
  • No mixed signals (canonical pointing one way, sitemap another, internal links a third)
  • Pagination handled correctly (rel=next/prev is deprecated, but consistent canonicals matter)
  • Parameter handling deliberate (UTM, session IDs, sort orders)
3. Rendering

Does the rendered HTML match what crawlers see?

  • Critical content visible without JavaScript (or properly server-rendered)
  • For SPAs: confirm Googlebot sees the rendered content (test with the URL Inspection tool)
  • No cloaking (showing different content to bots vs users)
  • Lazy-loaded content has proper loading attributes
  • Hydration errors do not strip content from the rendered DOM
4. Site architecture

Is the site structured for both users and crawlers?

  • Clear URL hierarchy that mirrors site structure
  • Important pages reachable in 3 clicks or fewer from the homepage
  • Internal linking distributes authority logically
  • Breadcrumb navigation present and marked up with schema
  • No orphan pages (pages with no internal links)
  • No redirect chains (one redirect max)
  • No 4xx errors on internally-linked URLs
5. Structured data and signals

Does the site speak crawler language?

  • Schema.org markup on appropriate page types
  • JSON-LD format (preferred over microdata)
  • Validates in the Rich Results Test
  • Organization or LocalBusiness schema on the homepage or about page
  • BreadcrumbList schema on nested pages
  • Author and publisher schema linked correctly on content pages
  • llms.txt present at the root (for AI crawlers, see seo-aeo-geo)
6. Page experience and security

Does the site meet the page experience baseline?

  • HTTPS on all pages, no mixed content
  • HSTS header set
  • Core Web Vitals pass (LCP, INP, CLS within thresholds)
  • Mobile-friendly (responsive, no horizontal scroll, tap targets sized correctly)
  • No intrusive interstitials on mobile
  • Stable URL structure (no random URL changes between deploys)
  • 404 pages return 404, not 200 with "page not found" content (soft 404)

Show full SKILL.md (338 more words)Show less

Workflow

  1. Define scope. Whole site, a subfolder, a migration check, or a specific issue.
  2. Confirm access. What can you actually see (HTML, robots, sitemap, search console, server logs, staging)?
  3. Crawl. Use a crawler to enumerate URLs and statuses. Sample if the site is huge.
  4. Run the 6-layer framework. Score each, note specific issues with example URLs.
  5. Cross-reference. Search console for what's actually indexed. Compare to sitemap and crawl output.
  6. Prioritize. Critical (blocks indexing or causes traffic loss), Important (suboptimal), Nice-to-have (polish).
  7. Write the report. Use the template in references/audit-template.md.

Failure patterns

  • Optimizing rankings on a page that is noindex. Always check indexability before content work.
  • Adding sitemaps without fixing canonical issues. A sitemap of duplicate URLs is worse than no sitemap.
  • Blocking crawlers from CSS or JS. Breaks Google's rendering. Common in over-aggressive robots.txt files.
  • Over-relying on canonical tags. Canonicals are hints, not directives. Use redirects when content actually moved.
  • Migrating without a redirect map. Single biggest cause of post-migration traffic loss.
  • Treating Core Web Vitals as the only ranking signal. Page experience matters but does not override relevance.

Output format

Default output is a markdown audit at seo-technical-audit.md. Structure:

  1. Scope and methodology
  2. Executive summary (3 to 5 critical findings)
  3. 6-layer score
  4. Critical issues (with example URLs)
  5. Important issues
  6. Nice-to-have polish
  7. Implementation roadmap (sequenced)

For migrations, include a redirect map as a CSV alongside the report.


If required data is unavailable

This skill's output depends on data, measurements, or tool results it cannot generate on its own. When a required input, tool, or data source is unavailable or unverifiable, the sanctioned output is the deliverable with the gap stated: what was needed, what was actually obtained or verified, and which parts of the output are affected. Fabricating, estimating, or interpolating a required number to complete the deliverable is never sanctioned. A stated gap is a complete answer.


Reference files

© rampstackco, 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 3 other files (references) in skills/seo-technical of rampstackco/claude-skills.

  • SKILL.md
  • README.md
  • references/audit-template.md
  • references/migration-checklist.md

Open the folder on GitHubat commit 482c9bf

Compare with similar skills

SEO Technical 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 Technical compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
SEO Technical this skillrampstackco/claude-skills935—~1.8kAutomated safety check: PassMIT
Technical SEOindranilbanerjee/digital-marketing-pro8541 repos~5.9kAutomated safety check: NotesMIT
Product Page SEOadobe/skills195—~2.8kAutomated safety check: PassApache-2.0
Agent Readiness Auditindranilbanerjee/digital-marketing-pro8541 repos~3.9kAutomated safety check: PassMIT
Site ArchitectureAvdLee/RocketSimApp80210 repos~3.3kAutomated safety check: PassCustom licence
GEO-First SEO Audit Toolzubair-trabzada/geo-seo-claude11k—~2.8kAutomated safety check: NotesMIT

Similar skills

  • Technical SEO

    indranilbanerjee/digital-marketing-pro

    Deep technical SEO knowledge module covering Core Web Vitals, crawlability, indexation, site architecture, JavaScript SEO, redirects, structured data, hreflang, and migrations — producing audit…

    854 GitHub starsUsed in 1 repo~5.9k tokens
    Marketing & SEOAuto-check: notes
  • Product Page SEO

    adobe/skills

    Optimize AEM Edge Delivery Services commerce product pages for search engine crawling and indexing.

    195 GitHub stars~2.8k tokensUpdated yesterday
    Marketing & SEOAuto-check passed
  • Agent Readiness Audit

    indranilbanerjee/digital-marketing-pro

    Audit whether AI agents and AI crawlers can actually use a site — robots.txt rules per AI crawler token (OpenAI, Anthropic and Perplexity bots, Google-Extended, Applebot-Extended)…

    854 GitHub starsUsed in 1 repo~3.9k tokens
    Data & AnalyticsAuto-check passed
  • Site Architecture

    AvdLee/RocketSimApp

    When the user wants to plan, map, or restructure their website's page hierarchy, navigation, URL structure, or internal linking.

    802 GitHub starsUsed in 10 repos~3.3k 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
  • SEO Ops Structural Checklist

    tigerless-labs/seo-ops

    Checks a site against a deterministic set of structural SEO and GEO checks, either running a crawler-eye report against a URL or reviewing code against the same checklist.

    700 GitHub stars~3.3k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check: notes

More from rampstackco/claude-skills

All 103 skills in this repo
  • After Action Report

    rampstackco/claude-skills

    Run a structured after-action review (postmortem, retrospective) on a launch, incident, or completed project to capture timeline, root cause analysis, contributing factors, and actionable lessons.

    935 GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Analytics Strategy

    rampstackco/claude-skills

    Design measurement frameworks including event taxonomy, KPI hierarchy, dashboard architecture, attribution models, and analytics implementation strategy.

    935 GitHub starsUsed in 1 repo~2.4k tokens
    Auto-check passed
  • Brand Style Guide

    rampstackco/claude-skills

    Build or audit a comprehensive brand style guide that documents the full brand system including story, logo system, color, typography, imagery, voice, applications, and dos/don'ts.

    935 GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • Brand Voice

    rampstackco/claude-skills

    Develop or document a complete brand voice and tone system covering voice attributes, tone shifts by context, vocabulary preferences, grammar rules, and copy examples.

    935 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Content And Copy

    rampstackco/claude-skills

    Write or edit website copy, blog content, and editorial pieces with attention to voice, structure, and goal.

    935 GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • Content Strategy

    rampstackco/claude-skills

    Develop a content strategy covering editorial positioning, content pillars, formats, calendar, governance, and topical authority planning.

    935 GitHub stars~2.6k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about SEO Technical

What does SEO Technical do?

Run a comprehensive technical SEO audit covering crawlability, indexability, rendering, site architecture, structured data, page experience, security, and internationalization. SEO Technical is an agent skill from rampstackco/claude-skills. Run a comprehensive technical SEO audit covering crawlability, indexability, rendering, site architecture, structured data, page experience, security, and internationalization.

When should I use SEO Technical?

SEO Technical fits situations like: the user asks about technical SEO; indexing problems; core Web Vitals; site-wide search performance.

How do I install SEO Technical in Claude Code?

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

How do I install SEO Technical in Codex?

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

Can I use SEO Technical 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 rampstackco/claude-skills --skill seo-technical -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-technical, .gemini/skills/seo-technical, .github/skills/seo-technical and .opencode/skills/seo-technical in your project.

What does SEO Technical need to run?

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

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

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

About 1.8k tokens (SKILL.md is roughly 7.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.8k tokens, read only when the agent opens those files.

What are the alternatives to SEO Technical?

Skills that share tags, products or a category with SEO Technical: Technical SEO (indranilbanerjee/digital-marketing-pro, 854 stars), Product Page SEO (adobe/skills, 195 stars), Agent Readiness Audit (indranilbanerjee/digital-marketing-pro, 854 stars) and Site Architecture (AvdLee/RocketSimApp, 802 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains SEO Technical?

rampstackco (a GitHub organization) maintains it in rampstackco/claude-skills, which has 935 GitHub stars. The repository holds 103 skills in this directory. The repository was last updated on October 7, 2026.

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