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
npx skills add Illyism/seo-skills --skill seo-roast -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/seo-roast/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/seo-roast/
1Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill seo-roast -a codex2Manually: put the files in place
.agents/skills/seo-roast/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill seo-roast -a cursor2Manually: put the files in place
.cursor/skills/seo-roast/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Illyism/seo-skills seo/seo-roast/SKILL.md2Manually: put the files in place
.github/skills/seo-roast/SKILL.md1Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill seo-roast -a gemini-cli2Platform CLI
gemini skills install https://github.com/Illyism/seo-skills --path seo/seo-roastManually: put the files in place
.devin/skills/seo-roast/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Illyism/seo-skills --skill seo-roast -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.