MCPInstall

seo-technical

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.

Installs
290
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/rampstackco/claude-skills --skill seo-technical
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads seo-technical automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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)

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

  • references/audit-template.md - Fillable technical SEO audit template.
  • references/migration-checklist.md - Pre and post-migration checklist (covers the highest-risk scenario).

FAQ

What does the seo-technical skill do?

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.

How do I install seo-technical?

Run npx skills add https://github.com/rampstackco/claude-skills --skill seo-technical in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/seo-technical/ (personal) or .claude/skills/seo-technical/ (project).

Which AI agents can use seo-technical?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is seo-technical safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains seo-technical?

It is published by rampstackco in rampstackco/claude-skills. It has 290 recorded installs.

More from rampstackco/claude-skills

View all →

art-direction

rampstackco/claude-skills

Direct visual and creative work for campaigns, photography, illustration, video, and branded experiences. Use this skill whenever the user wants to brief a photographer, direct illustrators, plan a creative campaign, develop visual concepts, or evaluate creative work for fit. Triggers on art direction, photo brief, photography brief, illustration brief, campaign concept, creative concept, visual direction, mood board, look and feel, visual treatment, video direction. Also triggers when the user has approved brand identity but needs to extend it into specific creative deliverables. Use creative-direction instead when the ask is the project-wide aesthetic brief that this skill consumes as input.

Media & Creative676 installs

brand-identity

rampstackco/claude-skills

Design or evaluate a brand visual identity system covering logo, color, typography, imagery direction, iconography, and motion principles. Use this skill whenever the user wants to design a logo, build a visual identity, define brand colors, choose brand typography, develop iconography, plan brand imagery, or evaluate an existing identity for cohesion. Triggers on logo design, brand identity, visual identity, brand mark, wordmark, monogram, color palette, brand colors, brand typography, type system, iconography, brand imagery, motion design, brand system, identity system. Also triggers when the user has a brand direction approved and now needs the visual artifacts that express it.

Marketing & SEO500 installs

logo-design

rampstackco/claude-skills

Open the skill to read its SKILL.md instructions.

448 installs

creative-direction

rampstackco/claude-skills

Walk the user through four directional axes (tone register, aesthetic philosophy, audience relationship, sensory ambition) and produce a structured aesthetic brief that downstream content, copy, design, and art-direction skills consume as required input. The aesthetic depth layer, distinct from creative-brief (operational kickoff: scope, audience, deliverables, constraints). Use when a project needs aesthetic coherence across many small decisions and the user has only a vague feeling, or when multiple downstream aesthetic-producing skills need a shared brief. Triggers on creative direction, aesthetic direction, set the aesthetic, define the visual direction, what's the vibe, what's the tone, the four axes. Does NOT fire for a general kickoff brief (use creative-brief), tactical single-piece work, already-documented direction, purely functional output, or locked production-stage work.

Media & Creative421 installs

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. Use this skill whenever the user wants to create brand guidelines, document an existing brand, build a brand book, audit an existing style guide for completeness, or produce the artifact that other teams will reference for years. Triggers on style guide, brand guidelines, brand book, brand standards, brand manual, style sheet, brand documentation, brand reference. Also triggers when the brand identity is finished and needs to be documented for handoff to designers, developers, vendors, or future team members.

Marketing & SEO393 installs

landing-page-copy

rampstackco/claude-skills

Write landing page copy with attention to the hero, value proposition, social proof, objection handling, and conversion-focused CTAs. Use this skill whenever the user wants to write a landing page, sales page, hero section, or any conversion-focused web copy. Triggers on landing page, sales page, hero copy, value proposition, headline, subheadline, hero section, CTA copy, conversion copy, opt-in page, squeeze page. Also triggers when the user has a marketing campaign or product launch needing dedicated conversion copy. Use cro-optimization instead when the page already exists and the ask is to lift its conversion rate through testing rather than to write the copy.

Marketing & SEO378 installs

Popular marketing & seo skills

View category →

reddit-automation

flowkit-labs/skills

Find Reddit threads where people are genuinely asking for what you offer, then draft short, genuinely helpful replies — disclosing your affiliation honestly and naming your product only when it truly answers the question. Two moves: discovery — scan the right subreddits for real needs (recommendation asks, expressed pain, competitor mentions) and rank the few threads where you can actually help; drafting — write from real experience, respect each community's self-promo rules, and keep a human in the loop to review and post. This markets on Reddit the honest way: contribute value, disclose who you are, never astroturf. Distilled from the playbook behind doany.ai's Reddit agent. Triggers on "find reddit opportunities", "reddit marketing", "reddit automation", "reply on reddit for my product", "reddit community engagement", "reddit lead gen", or any ask to turn Reddit threads into genuine, disclosed marketing replies.

Marketing & SEO1.1M installs

twitter-automation

101-skills/superpowers

Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet

Marketing & SEO880K installs

twitter-automation

magentosh/superpowers

Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet

Marketing & SEO771.7K installs

twitter-automation

qu-skills/superpowers

Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet

Marketing & SEO564.3K installs

product-launch-video

heygen-com/hyperframes

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

Marketing & SEO538.7K installs

twitter-automation

skills-shell/superpowers

Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet

Marketing & SEO453.7K installs