@illyism: Open-sourced my full SEO and AI-search stack for Claude Code and Cursor (30 skills + 4 live MCP servers I actually use …

X AI KOLs Timeline Tools

Summary

Illyism open-sourced a full SEO and AI-search stack for Claude Code and Cursor: 30 SKILL.md workflows plus 4 live MCP servers covering technical audits, programmatic SEO, video/YouTube transcript pulling, AI search visibility tracking, and tool benchmarking.

Open-sourced my full SEO and AI-search stack for Claude Code and Cursor (30 skills + 4 live MCP servers I actually use every day) 1. 30 open-source SEO skills (technical audits, programmatic SEO, BOFU pages, directory submissions, Ahrefs/GSC workflows): https://github.com/Illyism/seo-skills… 2. Full walkthrough and chained workflows for how I run them: https://il.ly/blog/seo-skills 3. Video and YouTube transcript MCP (pulls captions + frame OCR right into your agent): https://scribiz.com/mcp 4. Live AI search visibility tracker MCP: https://aiseotracker.com 5. Hands-on tool directory & benchmark MCP: https://awesome.tools Install all 30 skills in one line: npx skills add Illyism/seo-skills Most SEO agency retainers are basically 5 of these checklists run manually once a month tbh. Easier to just hand them to your coding agent and merge the PRs yourself!
Original Article
View Cached Full Text

Cached at: 11/21/26, 12:10 AM

Open-sourced my full SEO and AI-search stack for Claude Code and Cursor (30 skills + 4 live MCP servers I actually use every day)

  1. 30 open-source SEO skills (technical audits, programmatic SEO, BOFU pages, directory submissions, Ahrefs/GSC workflows): https://github.com/Illyism/seo-skills…

  2. Full walkthrough and chained workflows for how I run them: https://il.ly/blog/seo-skills

  3. Video and YouTube transcript MCP (pulls captions + frame OCR right into your agent): https://scribiz.com/mcp

  4. Live AI search visibility tracker MCP: https://aiseotracker.com

  5. Hands-on tool directory & benchmark MCP: https://awesome.tools

Install all 30 skills in one line: npx skills add Illyism/seo-skills

Most SEO agency retainers are basically 5 of these checklists run manually once a month tbh. Easier to just hand them to your coding agent and merge the PRs yourself!


Illyism/seo-skills

Source: https://github.com/Illyism/seo-skills

SEO Skills for Claude Code, Cursor & AI Agents

30 open-source SKILL.md workflows that end in a merged PR or a file in your repo, not an audit PDF.

GitHub Stars Agent Skills Specification Browse SEO Skills at il.ly/skills MIT License

Web catalog · Install · Skills · Workflows · MCP servers · Sponsors · FAQ

Terminal install of Illyism/seo-skills, a merged pull request that unblocks Bing and AI crawlers, and rising Google Search Console clicks

Install

# All 30 skills
npx skills add Illyism/seo-skills

# One skill
npx skills add Illyism/seo-skills --skill seo-autopilot

# List what is available
npx skills add Illyism/seo-skills --list

Each skill is a folder with one Markdown SKILL.md that follows the Agent Skills specification. The agent reads only the name and description at startup and opens the full file when your prompt matches.

EnvironmentWhere SKILL.md livesInstall
Claude Code.claude/skills/ or ~/.claude/skills/npx skills add Illyism/seo-skills -a claude-code
Cursor.cursor/skills/ or .agents/skills/npx skills add Illyism/seo-skills -a cursor
Codex, OpenCode, Windsurf, Cline, Roo Code.agents/skills/npx skills add Illyism/seo-skills
ChatGPT, Claude.ai, Perplexity, GrokPaste the MarkdownCopy any skill from il.ly/skills

What you get

Most SEO prompt packs produce checklists and health scores. Each skill here ends in something you can ship:

  • Diffs you can merge: rewritten titles and H1s, refreshed posts, robots.txt and bot rules, verified 301 maps, new /vs/ routes.
  • Proof in place of filler: proof-kb, seo-blog-images, and unslop-seo swap generic copy for your own benchmarks, screenshots, and charts.
  • One page at a time: blitz-seo puts 30 days of fixes, internal links, and backlinks on a single money page.
  • Google and AI search together: map the prompts buyers ask ChatGPT, Perplexity, Gemini, and AI Overviews, track who gets cited, and ship pages for the prompts you are missing.

Outputs shipped by the skills: a robots.ts crawler fix, a seo/kb/proof folder, a competitor /vs/ pricing page, and ChatGPT and Perplexity citations

All 30 SEO skills

Technical, research, and on-page

SkillWhat it shipsExample prompt
seo-autopilotA daily SEO agent for your repo with state in seo/: health checks, fact checks against recent commits, page-2 pushes, competitor sitemap diffs, a monthly keyword map“Run seo-autopilot on this repo and open a PR with today’s top fix”
seo-roastA blunt teardown that fixes crawl, robots.txt, programmatic, layout, and AI-visibility blockers in a PR, then writes seo/roast-roadmap.md ordered by revenue“Run seo-roast on our repo and fix the fatal blockers in a PR”
blitz-seoA 30-day sprint plan to rank one page for one money keyword“Run a 30-day blitz-seo sprint to push /pricing from #14 to the top 3”
ahrefs-researchAhrefs MCP or API v3 workflows: competitor top-pages gaps (seo/competitor-gaps.md) with scaffolded routes, a fake-DR filter (seo/link-targets.csv), subreddit topic mining, link-insertion page matching“Use ahrefs-research to diff our top pages against 5 competitors and scaffold the #1 gap”
dataforseo-serpLive SERP workflows: keyword clusters by top-10 URL overlap (seo/keyword-clusters.json), a free-tool filter by CPC and volume, AI Overview citation sources, an intent check before you write“Use dataforseo-serp to cluster these 40 keywords so we don’t cannibalize”
proof-kbA fact store in seo/kb/ (brand facts, benchmark and customer proof cards) that drafts pull from, plus route-fact to update every page when a number changes“Run proof-kb init and upgrade content/blog/postgres-branching.mdx with our benchmark”
vs-and-alternatives/vs/[competitor], /[competitor]-alternative, and “best for [persona]” routes built on sourced switching triggers, seat-based pricing math, and migration steps“Use vs-and-alternatives to ship /vs/billstack and link it from the footer”
internal-linkingA link-graph audit (scripts/internal-link-graph.mjs) and body links from your top posts into /pricing, /vs/*, and /tools/*“Run internal-linking to fix orphan money pages”
domain-migrationA rebrand or subdomain-to-subfolder move: full URL and backlink inventory, 1-hop 301 config, scripts/verify-redirects.sh, and backlink update emails“Run domain-migration to move blog.acme.com into acme.com/blog”
seo-title-optimizationTitle tag, frontmatter title, and H1 rewrites checked against the live SERP and truncation limits“Audit every page title in app/ and content/blog/ for CTR and truncation”
blog-refresherA refresh of a slipping post: compares it with the current top 10 and rewrites the weak sections in your voice“Use blog-refresher on content/blog/best-crm.mdx”
block-ai-scrapersA bot firewall that stops AI agents, curl, and headless scrapers from burning API and DB credits, keeps verified Googlebot indexing, and points blocked agents at your product“Add block-ai-scrapers to protect our /directory routes without hurting Googlebot”

AI search (GEO)

SkillWhat it shipsExample prompt
customer-journeyA 5-stage awareness map with the Google keywords and AI prompts buyers use at each stage“Map the customer-journey and AI search prompts for our B2B analytics SaaS”
aiseotrackerMCP setup for AI SEO Tracker: mentions, citations, and competitors across ChatGPT, Perplexity, Gemini, Copilot, and AI Overviews“Connect aiseotracker and check how ChatGPT and Perplexity rank our domain”
ai-seo-reportA short AI visibility brief from live scans: who gets cited, what changed, what to do“Give me this week’s ai-seo-report and tell me why competitors beat us in ChatGPT”
content-coverageA content plan and drafts for the prompt clusters where competitors get cited and you don’t“Run content-coverage for our missing Perplexity and ChatGPT prompts”
reddit-serpA queue (seo/reddit-serp-queue.md) of unlocked Reddit threads that rank on page 1 or get cited by AI, with replies written to survive moderation“Run reddit-serp for our category and draft replies”

Links and directories

SkillWhat it shipsExample prompt
directory-submissionsOne submission-manifest.json, the repo files that 15+ MCP and agent registries index, and a 50-directory sequence (850+ more)“Run directory-submissions to build our manifest and submit waves 1-3”
linkdrA backlink plan for LinkDR: a DR 30+ to DR 60+ mix for your budget and one checkout link you approve“Plan a $1,000 backlink campaign for our homepage with linkdr”
honest-link-outreachAn outreach batch file with a SEND/CUT prospect table and emails that state the ask first and differ in structure“Run honest-link-outreach on these 8 partner and blog domains”
awesome-toolsA submission to Awesome Tools over MCP or JSON API for a verified dofollow listing“Submit our app to awesome-tools and check if we qualify for the free listing”

Content and distribution

SkillWhat it shipsExample prompt
unslop-seoAn in-place edit that grounds vague claims in real facts, puts the answer in the first 40 words, and strips 20 AI writing patterns, with a check script“Run unslop-seo on content/blog/ci-guide.mdx”
seo-blog-imagesCover images, screenshots, and SVG charts that are generated, compressed, checked, and wired into the post with filenames, sizes, and alt text“Use seo-blog-images to add a cover and a benchmark chart to content/blog/benchmark.mdx”
youtube-seoTitles, a chaptered description, launch posts, and a VideoObject embed from a recording or .srt“Run youtube-seo on demo.srt and embed the video in the matching post”
parasite-and-prA syndication bundle in marketing/distribution/<slug>/: a press release with privacy-safe contact fields, a canonicalized Dev.to draft, a LinkedIn article, and a checklist“Run parasite-and-pr for our 2026 latency benchmark”
introShort blog intros matched to listicle, how-to, definition, or debate intent (examples)“Rewrite the opening of this post with intro for listicle intent”
scribizTranscripts with speakers, on-screen text, and chapters from video or audio via Scribiz“Transcribe this YouTube demo with scribiz and turn it into a tutorial post”
diff-marketingChangelog entries, feature articles, and launch posts drafted from recent commits and merged PRs“Read the last 2 weeks of commits with diff-marketing and draft 3 launch angles”

Copywriting

SkillWhat it shipsExample prompt
understand-customersA buyer research brief: pains, failed alternatives, desired outcome, and the words they use“Run understand-customers for indie Next.js founders tired of slow CI builds”
blitz-copyLanding page, email, and hook copy on the Hook, Spike, Payoff formula“Rewrite our hero section and pricing CTAs with blitz-copy”

For engineering skills (AI evals, Chrome Web Store releases), see Illyism/dev-skills.

End-to-end SEO workflows

The skills chain. Six that work well:

  1. Ship a post with first-hand proof. dataforseo-serp (cluster and check intent) → proof-kb (add your benchmarks) → seo-blog-images → unslop-seo → internal-linking → parasite-and-pr.
  2. Win buyers leaving a competitor. ahrefs-research (diff their top pages) → vs-and-alternatives → reddit-serp → honest-link-outreach.
  3. Push a page-2 URL into the top 3. seo-title-optimization → blog-refresher → intro → linkdr (2-4 DR 40+ links at the refreshed URL).
  4. Get cited by ChatGPT, Perplexity, and AI Overviews. customer-journey → aiseotracker → ai-seo-report → content-coverage.
  5. Launch from DR 0. understand-customers → blitz-copy → directory-submissions and awesome-tools → blitz-seo.
  6. Daily repo SEO. Run seo-autopilot on a schedule so the agent checks site health, verifies claims against recent commits, and opens PRs. Add diff-marketing weekly to turn shipped code into posts.

Live SEO data via MCP servers

A skill is the method. An MCP server gives the agent live data to run it on. Three are preconfigured in .mcp.json:

ServerEndpointWhat it gives the agent
AI SEO Trackerhttps://aiseotracker.com/api/agent/mcp (repo)Prompt rankings, cited URLs, and competitor share across ChatGPT, Perplexity, Gemini, Copilot, and AI Overviews
Scribizhttps://scribiz.com/mcpTranscripts with speakers, on-screen text, summaries, and chapters
Awesome Toolshttps://awesome.tools/mcp (repo)Tool search, directory submissions, and backlink verification

Related, not in .mcp.json: the LinkDR agent skill plans backlink orders and returns one checkout link, and the GenPPT MCP turns an audit or roadmap into a .pptx or PDF deck.

Companion resources

Sponsors

MIT-licensed and maintained by Ilias Ism, supported by these products:

ProductWhat it does
LinkDRManaged backlinks at DR 30-60+. You can approve every publisher site before placement. 15% off monthly plans.
AI SEO TrackerTracks whether ChatGPT, Perplexity, Gemini, Copilot, and AI Overviews cite your brand, and which competitor pages they cite instead.
GenPPTTurns notes, reports, and PDFs into editable PowerPoint and Google Slides decks.
ScribizTranscribes video and audio with speaker labels, on-screen text, and chapters. Web, macOS, Android, CLI.
Awesome ToolsA curated SaaS and developer tools directory. Submit your product for a verified dofollow listing.
SEO RoastA recorded 20-minute video teardown of your site with a 90-day plan.
XOutlierA free Chrome extension that finds outlier posts across 390,000+ creators on X.

FAQ

What are SEO skills for AI agents?

A skill is a folder with a SKILL.md file: instructions, checks, and output templates that teach a coding agent (Claude Code, Cursor, Codex, OpenCode, Windsurf) one SEO job, such as a technical audit, a title rewrite, a content refresh, or a backlink plan.

How do I use them in Claude Code or Cursor?

Run npx skills add Illyism/seo-skills in your project, or globally. The agent loads a skill when your prompt matches its description. You can also name it: “Use blog-refresher on content/blog/post.mdx”.

Can I use them in ChatGPT, Claude.ai, or Perplexity?

Yes. Open il.ly/skills, pick a skill, and copy the prompt into the chat.

What is the difference between a skill and an MCP server?

A skill tells the agent how to do the job. An MCP server connects it to live data and actions: SERPs, AI citation scans, transcripts, checkouts. Most workflows here use both.

License

MIT © Ilias Ism

Similar Articles