We Open-Sourced Our Claude SEO Skills

The two Claude skills we use to plan, write and check every SEO page, built from our audit of 150 pages against Google Search Console. Free, MIT licensed, and installable in one command.

Yashas Jagadeesh5 min read
We Open-Sourced Our Claude SEO Skills

We have released the two Claude skills we use on every SEO page we write: seo-content, which decides what page to build and checks it before it goes live, and client-web-copy, which keeps the sentences plain and specific. They are free under the MIT licence, and the rules in them come from our own Search Console data, not from a list of tips.

The code is on GitHub, and the Claude SEO skills page has the install steps.

What are Claude skills?

A skill is a folder with a SKILL.md file of instructions, plus reference files and scripts. Claude loads it when a task matches its description, so the same process runs every time without pasting a long prompt (Anthropic: Agent Skills). We wrote about how we package our own processes this way in our post on harness engineering.

Why build an SEO skill from our own data?

Most SEO advice is the same list of tips, and a model trained on the web repeats it. We wanted rules we could defend with numbers. In November 2026 we checked 76 pages on our site and 74 pages from six client sites against three months of Google Search Console data. The results changed how we work, and they are what the skill enforces.

What the audit found:

FindingData
The page type matters more than the writingPrice pages, free tools and product pages for a specific job won on every site. 13 of our 36 blog posts were not indexed, all of them generic.
First-hand material separates indexed from ignoredEvery guide with our own prices was indexed; every trend and tips post without them was skipped.
Writing style alone does not predict rankingOur top pages had longer sentences (median 20.9 words) than the posts Google skipped (15.6).
Hype words go with weaker pages0.3 per 1,000 words on strong client pages against 1.1 on weak ones.
Question headings and FAQ schema go with stronger pagesA median of 3 question headings against 0; FAQ schema on 81% against 69%.

The full write-up is in how to write SEO content.

What does the seo-content skill do?

It works in four modes: plan (should we build this page at all?), write, rewrite and audit. In each one it picks the page type from the search intent, puts a short answer under the heading, turns People Also Ask questions into headings, asks for a linked source for every statistic, and covers schema, internal links, llms.txt and indexing. Before a rewrite, it records what the page already ranks for, so the new version keeps those phrases.

It ships with two Python scripts that need no API keys. One checks a single page before publishing: title and description length, one H1, canonical, schema types, question headings, hype words, statistics without a source, and links. The other scores many pages for an audit.

How have we used it?

Pages built or rewritten with the skill this month:

  • Our technical SEO checklist and our guide to writing SEO content, both rewritten from posts Google had not indexed.
  • Our AI SEO services page, planned from a go / no-go brief with keyword, results-page and AI citation research.
  • Our digital marketing for dental clinics page, including the dental advertising rules the skill now checks for.
  • An audit of our 13 posts Google had not indexed, which ended in two rewrites and ten merges into stronger pages.

What did we leave out?

Client names. The evidence describes client sites by type ("a dental clinic", "a phone repair company") instead of naming them. We also removed the internal tools we use for keyword and ranking data, and replaced them with the ones most teams have: Search Console, DataForSEO, Ahrefs or Semrush, or a manual search from the right location.

How do you install the skills?

  • Claude Code: run /plugin marketplace add social-script/claude-seo-skills, then /plugin install seo-skills@social-script.
  • Other agents that read SKILL.md: run npx skills add social-script/claude-seo-skills.
  • By hand: copy the two folders from the repository's skills directory into ~/.claude/skills.
  • Claude.ai: upload the zip files from the latest release in Settings, Capabilities, Skills.

Frequently asked questions

Are the Claude SEO skills free? Yes. They are open source under the MIT licence, and you can use them on client work.

Do I need an SEO tool to use them? No. Search Console and a manual search are enough to start. Keyword data from any provider makes the plan step more accurate.

Will you update them? Yes. We plan to re-run the audit every six months and update the evidence file. Issues and pull requests on GitHub are welcome.

Written byYashas Jagadeesh
Share

Need help with seo & performance marketing?

We optimize your website for search engines and run data-driven marketing campaigns.

Explore our SEO & Performance Marketing service

See This in Action

Real-world projects that bring these concepts to life

Work With Us

Ready to build something remarkable?

We design and develop websites that help brands grow. Let us bring your vision to life.

Start a Project