Technical SEO — SKILL.md files for AI agents

Free, ready-to-run technical SEO skills for Claude, Claude Code, OpenAI Codex and any agent that reads the Agent Skills format. Each skill is a single SKILL.md: a senior practitioner's workflow — when to use it, the inputs to ask for, a numbered process, decision rules, an output template and sources — loaded only when a task needs it.

Part of the Marketing Skills library by Afeez Adebayo · Browse online

Install

Each skill is its own folder with a SKILL.md, so you can drop any folder straight into an agent.

Claude Code

git clone https://github.com/afeezadebayo/technical-seo-skills.git
cp -r technical-seo-skills/xml-sitemaps ~/.claude/skills/        # all projects
# or  .claude/skills/   inside one project

OpenAI Codex

cp -r technical-seo-skills/xml-sitemaps ~/.agents/skills/         # all repos

Claude.ai / Desktop — zip a skill folder, then Settings → Capabilities → Skills → Upload skill (code execution must be enabled). To bulk-load the whole category into a Claude Project, custom GPT or knowledge base, grab the single-folder .zip from the library page.

Then start a new session and ask your agent which skills it can use.

What's inside

| Skill | What it does | |---|---| | technical-seo-audit | Run a complete, prioritised technical SEO audit of any website, from crawl and indexation to rendering, speed, schema and AI crawler access. | | crawlability-indexation-audit | Diagnose why pages aren't crawled, rendered or indexed, and fix the earliest broken step first. | | robots-directives | Write, audit, test and debug robots.txt, meta robots and X-Robots-Tag for search and AI crawlers. | | xml-sitemaps | Plan, generate, audit, segment and monitor XML sitemaps and sitemap indexes. | | canonicalization | Find duplicate and near-duplicate URLs and make Google choose the canonical you want. | | redirects-status-codes | Audit and fix redirects, chains, 404/410, soft 404s and 5xx, and build tested redirect maps. | | site-migration | Plan, run and monitor SEO-safe migrations with benchmarks, redirect maps and a 90-day recovery watch. | | internal-linking | Audit and design internal linking and site architecture to route equity to the pages that matter. | | faceted-navigation-parameters | Control crawling and indexing of filters, facets, sorting, pagination and URL parameters. | | javascript-seo | Make JavaScript-heavy sites (React, Next.js, Vue, SPAs) crawlable and indexable. | | structured-data | Plan, write, validate and debug structured data (JSON-LD and schema.org) for rich results. | | log-file-analysis | Analyse server, CDN or hosting logs to see how Googlebot and AI crawlers really crawl a site. | | core-web-vitals | Diagnose and improve Core Web Vitals (LCP, INP, CLS) from field data, with template-level fixes. | | lcp-optimisation | Diagnose and fix Largest Contentful Paint through its four subparts. | | inp-optimisation | Diagnose and fix Interaction to Next Paint across its three phases. | | cls-optimisation | Diagnose and fix Cumulative Layout Shift with reserved space, overlay banners and font fixes. |

How these skills work

Agents use progressive disclosure: they read each skill's name and description (~100 tokens) at the start of a session and load the full SKILL.md only when your request matches — so you can install many without filling the context window.

Author & licence

By Afeez Adebayo — Marketing, SEO & Growth (SEO & Organic Growth at Grey, YC W22). LinkedIn · X · Newsletter

Released under CC BY 4.0 — use, share and adapt, including commercially, with credit to Afeez Adebayo and a link to the source page in each file.

_{Keywords: technical SEO skills, SKILL.md, Agent Skills, Claude skills, Claude Code skills, Codex skills, AI agent skills, SEO audit, crawlability, indexation, robots.txt, XML sitemaps, canonicalization, redirects, JavaScript SEO, Core Web Vitals, structured data, log file analysis, site migration.}