open-seo: Skill for Claude Code

.agents/skills/evaluate-skill/SKILL.md

evaluate-skill is a skill for Claude Code, Codex from every-app/open-seo. It costs 66 tokens per session (1,527 once invoked), scanned A, original, MIT.

A workflow for testing an OpenSEO skill, meaning instructions that guide an AI agent through search-engine work. It runs isolated coding-agent sessions against a local server and compares the reports they produce.

In plain words
What is it for?
Use it to evaluate skills such as SEO audits or keyword research with test websites, controlled local data, and scored reports.
Why use it?
It shows whether a skill improves real output instead of only making its instruction file look cleaner.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: runs codex exec; installed under .agents/ (shared by several agents); mentions Codex.

This is every-app/open-seo's own configuration. It tells Claude Code and Codex how to work on open-seo itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything open-seo configures →

About the project

OpenSEO is an open-source SEO platform for keyword research, rank tracking, competitor analysis, backlink analysis, site audits, and AI visibility work. It connects SEO data to AI agents through an MCP server and reusable agent skills, while allowing users to supply their own DataForSEO API key and self-host the tool. Catalogue add-ons guide agents through OpenSEO's SEO workflows.

every-app/open-seo · 23,850 stars · on GitHub · openseo.so

Reuse

Borrowing it

Nothing to install: this file belongs to every-app/open-seo. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/every-app/open-seo/main/.agents/skills/evaluate-skill/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/every-app/open-seo

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for evaluate-skill

README.md
[![agentmods](https://agentmods.dev/badge/skills/every-app/open-seo/evaluate-skill/github.svg)](https://agentmods.dev/skills/every-app/open-seo/evaluate-skill)
Your own site
<a href="https://agentmods.dev/skills/every-app/open-seo/evaluate-skill"><img src="https://agentmods.dev/badge/skills/every-app/open-seo/evaluate-skill/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for evaluate-skill

Your own site · 80×15
<a href="https://agentmods.dev/skills/every-app/open-seo/evaluate-skill"><img src="https://agentmods.dev/badge/skills/every-app/open-seo/evaluate-skill.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 66 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,527 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00066 $0.01527
Opus 5.5 $0.00026 $0.00611
Sonnet 5.5 $0.00013 $0.00305
Haiku 4.5 $0.00007 $0.00153

Measured 27d ago against content hash b422c5c36578, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

evaluate-skill scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 27d ago.

The scan reads SKILL.md. This mod also ships 2 executable files (scripts/report-text.mjs, scripts/run.mjs), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agents/skills/evaluate-skill/SKILL.md · 90 lines

How it starts

The opening of the file, as written. The whole thing — 90 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Evaluate a skill

A skill edit is only as good as the reports it produces. This workflow runs the candidate skill in sessions that know nothing except the skill file, a one-line business brief, and a locked-down local MCP endpoint, then compares what came back.

Prerequisites

  • Local server in no-auth mode: AUTH_MODE=local_noauth in .env.local, then pnpm db:migrate:local and pnpm dev (or pnpm dev:agents). Pass the URL it prints, with /mcp appended, as --endpoint. Default local D1, never remote bindings or remote Postgres. Keep it private; it has no login.
  • codex CLI on the path. Runs use its configured default model at high reasoning; record the resolved model from the events log if you need to name it.
  • Research credits: the local server still calls DataForSEO. An audit run makes 20 to 40 tool calls. Do not run more sessions than the comparison needs.

Run

node .agents/skills/evaluate-skill/scripts/run.mjs \
  --skill seo-audit \
  --site example.com --site holdout.example \
  --brief "Evaluation brief: Acme at example.com sells <what>. The goal is relevant organic visitors who could become customers. No first-party analytics are connected." \
  --brief "Evaluation brief: <the holdout business>. ..." \
  --endpoint http://<local-dev-host>/mcp

Runs take about 10 to 14 minutes and execute in parallel. Launch the script detached, because a tool-call timeout that kills the shell kills the sessions too:

(nohup node .agents/skills/evaluate-skill/scripts/run.mjs ... > .logs/eval.log 2>&1 &)

What the script does, per site:

  1. Copies the candidate skill and seo-report into a fresh temp folder. Edits during the run cannot change its instructions; the manifest records the skill hashes.
  2. Creates a new local project seeded only with the brief.
  3. Starts a gateway in front of the local MCP that allows a fixed tool list and rejects any call for another project id, then probes that rejection before starting.
  4. Runs codex exec ephemeral, ignoring user config, memories, apps, plugins, and multi-agent, with the skill's self-review as the only reviewer.
  5. Captures the saved report HTML, every MCP call and response, the event stream, and the final message under the output folder.

Read the full file on GitHub · 90 lines

Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 27d ago First seen · 90 lines · 66 tokens per session scan A b422c5c36578

Subscribe to this mod's changes

evaluate-skill is a skill published in the GitHub repository every-app/open-seo (23,850 stars, last pushed 3d ago), licensed MIT. It adds 66 tokens to every session and 1,527 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-20.

Related

Other skills, from other repositories

playground

Launches a local WordPress Playground site with The SEO Framework mounted, captures front-end SEO artifacts, and compares before/after plugin states. Use when testing regressions, reproducing bugs, changing meta/sitemap/robots/ schema/oEmbed/admin SEO output, checking WordPress version behavior, plugin conflicts, or…

sybrew/the-seo-framework · 73 tokens

wp-finalize-run

The check detail of the /wp-finalize run, split out of commands/wp-finalize.md so the command stays a short map — bilingual coverage, theme structure, the WP-CLI runtime validation, the GEO and agent-readiness report, and the three demo-parity layers (static, WP-CLI, measured visual parity). Use when /wp-finalize…

yojahny55/claude-wp-builder · 131 tokens

wp-demo-verify-run

The step detail of the /wp-demo-verify run, split out of commands/wp-demo-verify.md so the command stays a short map — Step 2a (the impeccable detector and its gate), Step 2b (the scroll walk, Firefox pass, --no-motion, fractional widths and the exit-code 2 fallback) and Step 3 (reading every finding kind). Use when…

yojahny55/claude-wp-builder · 147 tokens

test-master

Generates test files, creates mocking strategies, analyzes code coverage, designs test architectures, and produces test plans and defect reports across functional, performance, and security testing disciplines. Use when writing unit tests, integration tests, or E2E tests; creating test strategies or automation…

Jeffallan/claude-skills · 104 tokens

verify-omnigent

Drive Omnigent the way a user does and prove a behavior with recorded evidence, using an isolated server, runner, and mock model plus a feature map of every user entry point. Load before reproducing a user-facing bug, before claiming a fix works, or when reviewing whether a change covered every surface (session vs.…

omnigent-ai/omnigent · 100 tokens

dogfood

Systematically explore and test a mobile app on iOS/Android with agent-device to find bugs, UX issues, and other problems. Use when asked to dogfood, QA, exploratory test, find issues, bug hunt, or test this app on mobile.

callstack/agent-device · 55 tokens