Skip to main content
skill CX Codex

seo-roast — Claude Code skill: SEO audit and install

The seo-roast Claude Code skill audits a site and its code, then fixes critical SEO blockers in a PR. It runs on requests to investigate rankings, traffic, or conversions and produces a prioritized roadmap.

no license 446 installs ★ 1,797 updated 2026-11-16

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add Illyism/seo-skills --skill seo-roast -a claude-code
Open on GitHub

What seo-roast does

seo-roast examines what keeps important pages out of search or prevents them from converting, then patches critical issues in a PR. It checks crawling and indexing first, followed by dynamic pages and other SEO blockers. Minor cleanup waits until problems affecting search or conversions are resolved.

The audit needs a domain, revenue-driving pages, the main conversion, and repository access. It inspects routes, robots.txt, and the sitemap; GSC, Ahrefs, or DataForSEO data can be used when available. Repository access is needed to inspect the code and submit fixes in a PR.

The deliverables include a fix PR and seo/roast-roadmap.md, with tasks ordered by revenue impact. A client deck is optional. The roadmap can also cover site authority and visibility in AI search.

What it helps with

  • find crawl and indexing blockers on key pages
  • patch SEO issues in code and open a PR
  • inspect dynamic pages and locale routes
  • rank SEO tasks by revenue impact

Example prompts for the agent

  • Audit this site’s SEO and fix the critical issues in a PR.
  • Find why the site’s pages are not gaining search visibility and write a roadmap.
  • Review the site code for SEO issues that could be hurting conversions.

How to install seo-roast

1Skills CLI (Vercel)

npx skills add Illyism/seo-skills --skill seo-roast -a claude-code

2Manually: put the files in place

~/.claude/skills/seo-roast/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/seo-roast/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about seo-roast

How do I install seo-roast in Claude Code?

Run npx skills add Illyism/seo-skills --skill seo-roast -a claude-code. The skill file is at ~/.claude/skills/seo-roast/SKILL.md.

What does seo-roast do?

It audits a site and its repository, patches critical SEO blockers in a PR, and writes seo/roast-roadmap.md with remaining work ranked by revenue impact.

What does seo-roast need to run?

It needs a domain, revenue-driving pages, the main conversion, and repository access. GSC, Ahrefs, or DataForSEO data can be added when available.

Similar skills

All skills for SEO and GEO →

From the same set29

The whole set →
intro Writes concise blog intros in the Semrush style with journey teasers and intent matching. CX Codex +1 777installs scribiz The scribiz skill transcribes and analyzes video or audio files in Claude Code. It extracts transcripts, captions, and chapters for content workflows. CX Codex +1 743installs linkdr This Claude Code skill connects link-building requests with LinkDR’s managed backlink service. It activates for guest post requests and DR-tier placements that need human approval. CX Codex +1 743installs block-ai-scrapers block-ai-scrapers — a skill that prevents AI agents from scraping your site while preserving SEO indexing. It implements multi-layer request filtering to block unwanted bots. CX Codex +1 565installs content-coverage The content-coverage skill for Claude Code plans and writes blog posts for missing AI search prompts from live MCP data. It runs for content campaigns or ChatGPT coverage gaps. CX Codex +1 440installs ai-seo-report The ai-seo-report skill for Claude Code compiles AI search visibility reports using live MCP data. It runs when a search visibility summary is requested. CX Codex +1 436installs internal-linking The internal-linking skill for Claude Code automates internal link building, routing traffic from informational posts to 'money pages'. It runs when a blog generates traffic but lacks conversions or signups. CX Codex +1 433installs aiseotracker aiseotracker — a skill for Claude Code and Cursor that connects an MCP server to track brand visibility across AI search engines. CX Codex +1 430installs

Project sponsors

Companies that keep this analytics open