explaingit

aleclindz/seo-skill-bench

Analysis updated 2026-05-18

110JavaScriptAudience · developerComplexity · 3/5Setup · moderate

TLDR

An open benchmark that runs Claude Code SEO skills for real against test websites with planted, known defects and scores them against a hidden answer key.

Mindmap

mindmap
  root((seo-skill-bench))
    What it does
      Benchmarks SEO skills
      Runs real headless agents
      Planted defect answer keys
    Tech stack
      JavaScript and Node.js
      Claude Code CLI
    Use cases
      Compare SEO skills fairly
      Test your own skill
      Study benchmark design
    Audience
      Developers
      Claude Code skill authors

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Compare real world performance of different Claude Code SEO skills before choosing one.

USE CASE 2

Test your own SEO skill against fixture sites with a hidden answer key.

USE CASE 3

See which SEO skills avoid hallucinating unnecessary fixes on already correct pages.

USE CASE 4

Understand how a deterministic, answer key based benchmark can be designed and scored.

What is it built with?

JavaScriptNode.jsClaude Code

How does it compare?

aleclindz/seo-skill-benchpeng-zhihui/cheese-uestckarpathy/notpygamejs
Stars110110109
LanguageJavaScriptJavaScriptJavaScript
Last pushed2017-01-132023-10-17
MaintenanceDormantDormant
Setup difficultymoderatemoderateeasy
Complexity3/52/52/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Running the benchmark requires Claude Code access and headless execution against fixture sites, reading the leaderboard needs no setup at all.

No license information is stated in the visible README, so reuse and redistribution terms are unclear.

In plain English

seo-skill-bench is a benchmark that compares different SEO focused skills built for Claude Code and similar coding agents. Instead of trusting a skill's description or its star count on GitHub, this project actually installs each skill in a real agent session and points it at test websites that have known problems planted inside them on purpose. Each test site is a small but realistic setup: a live static website, a slightly out of date source code repository, and a sample Google Search Console data export, along with a hidden answer key listing exactly what is wrong with the site and which recommendations would be traps, meaning things that sound like fixes but are not actually needed. Because the correct answers are known ahead of time, most scoring is done automatically by comparing what the skill found and recommended against that answer key, rather than relying on a judge's opinion. The project follows a few strict rules to keep the comparison fair: every skill gets the exact same short prompt with no hints about what to look for, each skill runs in its own isolated workspace so results cannot leak between entrants, and the scoring rubric is written down and frozen before any runs happen. A small part of the score, judging the overall quality of strategy suggested, still needs a human style judgment call, so that part is scored by an anonymized panel that does not know which skill produced which answer. The README includes a public leaderboard showing how several real SEO skills scored across categories like defect detection, avoiding traps, and overall judgment, along with notes that the maintainer's own skill is included as an entrant and has previously placed last in one of these runs. Full scoring weights and methodology are documented separately in the repository.

Copy-paste prompts

Prompt 1
Explain how seo-skill-bench scores defect detection versus trap avoidance.
Prompt 2
Help me run this benchmark against my own SEO skill for Claude Code.
Prompt 3
Show me how the planted-defect fixture sites are structured in this project.
Prompt 4
Walk me through the rubric weights defined in RUBRIC.md for this benchmark.

Frequently asked questions

What is seo-skill-bench?

An open benchmark that runs Claude Code SEO skills for real against test websites with planted, known defects and scores them against a hidden answer key.

What language is seo-skill-bench written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js, Claude Code.

What license does seo-skill-bench use?

No license information is stated in the visible README, so reuse and redistribution terms are unclear.

How hard is seo-skill-bench to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is seo-skill-bench for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.