seo-skills README

The project's README from github.com/Illyism/seo-skills. As one markdown file: README.md.

SEO Skills for AI Agents

Open-source SEO skills for Claude Code, Cursor, Codex and any agent that reads SKILL.md files. Install one and your agent can run daily SEO checks, fix title tags, refresh posts that slipped, buy backlinks, map search intent, and write the copy that ranks.

Browse them at il.ly/skills.

Install

# Install the SEO autopilot skill
npx skills add Illyism/seo-skills --skill seo-autopilot

# Install all skills
npx skills add Illyism/seo-skills

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

SEO skills

Skill What it does
seo-autopilot Daily agent that runs SEO end to end: site health checks, fixes, keyword map, articles, comparison pages, free tools, link drafts and AI answer tracking
blitz-seo A 30-day sprint to rank one high-value page for one money keyword
seo-title-optimization Rewrite and audit title tags, H1s and meta titles for rankings and click-through rate
blog-refresher Refresh an existing post with a SERP gap analysis so it outranks the pages above it
linkdr Buy managed backlinks from LinkDR: plan a DR-tier mix for a budget and send one checkout link

Content skills

Skill What it does
intro Short blog intros with a journey teaser, matched to listicle, how-to or definition intent
scribiz Transcripts, subtitles, summaries and chapters for any video with Scribiz, and video-to-blog workflows

Marketing skills

Skill What it does
customer-journey Map the 5-stage awareness journey with the prompts people type into Google and ChatGPT at each stage
diff-marketing Turn recent commits and merged PRs into blog posts, launch posts, changelogs and emails

Copywriting skills

Skill What it does
blitz-copy Landing pages, headlines, SEO titles, cold emails and posts using Hook → Spike → Payoff
understand-customers Research customer pains and language before writing copy

Looking for developer skills like AI evals? See Illyism/dev-skills.

Structure

Each skill is a folder with a SKILL.md that follows the Agent Skills spec:

<category>/<skill-name>/SKILL.md

Free SEO checklist

Want to check a site by hand first? Get the SEO launch checklist: 71 checks, each with a test you can run and a pass condition, covering crawling, page basics, speed, content, links and AI answers. Signing up also adds you to my newsletter, where I share what I learn building LinkDR, GenPPT and AI SEO Tracker. Unsubscribe anytime.

License

MIT, by Ilias Ism

seo-skills (Illyism/seo-skills)

Searching Database…

What is this?A collection of open-source SEO skills for AI agents like Claude Code, Cursor and Codex, covering daily SEO checks, title tag fixes, blog refreshes, backlink buying, customer journey mapping and copywriting.
Is this a single tool or a bundle of separate skills?It is a bundle: each skill is its own folder containing a SKILL.md file following the Agent Skills spec, and you install the ones you want.
How do I install these skills into my agent?You install individual skill folders (each with a SKILL.md) into an agent that supports the Agent Skills spec, such as Claude Code, Cursor or Codex.
Which coding agents can use these skills?Any agent that reads SKILL.md files, explicitly mentioned are Claude Code, Cursor and Codex.
Does the linkdr skill give me backlinks for free?No, linkdr is a skill that plans and buys managed backlinks from the LinkDR service for a budget, so it involves real spend, not a free feature.
What does the seo-autopilot skill actually do day to day?It is a daily agent that runs SEO end to end: site health checks, fixes, keyword mapping, articles, comparison pages, free tools, link drafts and AI answer tracking.
Is there a way to check SEO manually without installing an agent skill?Yes, the project offers a free SEO launch checklist with 71 checks covering crawling, page basics, speed, content, links and AI answers, available via signup (which also joins a newsletter).
What is diff-marketing used for?It turns recent commits and merged PRs into blog posts, launch posts, changelogs and emails, useful for developers who want to market their releases.
Is there a companion skill set for developers rather than marketers?Yes, the author points to a separate repo, Illyism/dev-skills, for developer-focused skills like AI evals.
Creator
Illyism
Size
<0.1 MB
Stars
527
Updated
CommitOct 06
Age
4mo
Commits · 90 Days