Cold Run
БесплатноПоддерживаетсяEnables you to audit your AI agent skills by running each one against an agent that cannot see it, diffing the resulting artifacts, and grading whether each ski
Описание
Enables you to audit your AI agent skills by running each one against an agent that cannot see it, diffing the resulting artifacts, and grading whether each skill genuinely improves, changes nothing, or worsens the output.
README
I tested 47 agent skills. I deleted 23 of them. Three were making Claude's code worse.
Then I built the tool that does it, pointed it at the 24 survivors, and it graded three of the first five NEGATIVE.
That is not a bug. It is the most interesting thing I found, and I am publishing it rather than waiting for you to find it: runs/bare-baseline/.
npx cold-run
The finding
A skill that does nothing is the boring failure. The common one is worse:
A skill spends the agent's attention. It buys a specific check, and it pays for that check out of everything else the task needed.
Asked to build a cached lookup, the agent following amplification-check added jitter and
single-flight — exactly what the skill asks for. The agent that had never seen the skill added
those and an LRU cap, stale-while-revalidate, and negative caching. The skilled version's cache
grows without bound.
Asked to add retries inside a Lambda, the skilled agent produced a tidy retry-budget table and a
blanket except that retries a definitive 404 as eagerly as a timeout.
You cannot see this by reading a skill. Both of those skills are well written. You only see it by running the task twice and diffing the artifacts.
What it does
Finds your skills, picks an adversarial test task for each one, runs a cold/skilled pair in parallel, and tells you which of your skills change nothing.
cold-run v0.1 — 30 skills in ~/.claude/skills
REAL retry-guard added a breaker + cap; cold declined one
NONE be-thorough cold output was identical
NONE check-edge-cases cold found two more edge cases
NEGATIVE refactor-first skilled dropped a null check cold kept
...
11 change nothing.
2 make the output worse.
17 earn their place.
Deleting the 13 frees ~7,400 tokens of always-loaded
context, every session.
full report -> cold-run-report.md
every transcript -> .cold-run/
It never deletes anything. It writes the report and every transcript, and the decision is yours.
Cost is real and it asks first. Four model calls per skill. On a library over 12 it tests a
spread of five so your first run is cheap; --all does the rest.
npx cold-run # auto-finds your skills
npx cold-run path/to/skills # or point it somewhere
npx cold-run --all --yes # everything, no prompt
Runs through your local claude CLI if you have one, otherwise ANTHROPIC_API_KEY.
Zero dependencies — npx starts instantly.
As an MCP server
Same audit, driven by whatever agent you already talk to — Claude Code, Claude Desktop, Cursor. It uses your agent's own subagents, so there's no second API key and no hidden spend.
claude mcp add cold-run -- npx -y --package=cold-run cold-run-mcp
Any other MCP client
{
"mcpServers": {
"cold-run": {
"command": "npx",
"args": ["-y", "--package=cold-run", "cold-run-mcp"]
}
}
}
Then just ask: "which of my skills actually do anything?"
The five verdicts
| REAL | The artifact differs materially and the skilled run is better. |
| MARGINAL | A small real addition on top of an output the cold run already got right. |
| NONE | Indistinguishable — or the skilled run only talked about the principle. Talking is not changing. |
| NEGATIVE | The cold output was better. This is not rare. Three of my 47 landed here. |
| INVALID | One side never produced an artifact, so the pair is void. Reported, never counted. A verdict from a run that did not happen is worse than no verdict. |
The 24 that survived, and the asterisk on them
The library that produced this tool is in skills/. Every one has a recorded cold/skilled pair behind it — see EVIDENCE.md and runs/ledger.md.
Read this before you install them. That audit ran both agents under my machine's global
operating contracts — house rules that force stop-and-ask behaviour and a fixed reporting format.
cold-run deliberately strips all of that. Under the bare baseline, three of the first five
survivors grade NEGATIVE. Both results are published, in full, with transcripts:
runs/bare-baseline/.
Which number applies to you depends on what your own CLAUDE.md already forces. Neither has been
run at full scale under the bare baseline. I would rather ship the contradiction than hide it.
The 23 that didn't make it, and why none could be repaired, are in runs/dropped.md.
A few of the survivors, so you can judge the bar:
yagni-audit— "implement a rate limiter." Cold wrote ~700 lines: sync, async, keyed, Redis, Lua, decorators. Skilled wrote 15.trust-source-check— cold authenticated services with a shared static env-var token. Skilled required a JWKS-verified OIDC token with audience pinning.reverse-path-proof— skilled ran a real Postgres container and found the rollback aborts on a 255-character name, wiping every name in the table. Cold had the same bug.pit-of-success— cold shipped immediate hard delete as the default. Skilled made it reversible for 30 days and put purge behind a confirmation echoing the user id.
Install them the normal way, or don't. The tool is the point.
Skills are graded on two gates here, not one
- Cold-run delta — does it change the artifact? 23 skills failed this. → EVIDENCE.md
- Routing — does the description actually get the skill loaded? A perfect skill with a description that never fires is dead weight that still costs tokens. Tested as a classifier against 360 written requests; two rounds failed before all 24 passed. → tests/router/
A skill passing one and failing the other is still broken.
vs. skill-doctor
skill-doctor is a linter. It reads your skills and checks frontmatter validity, broken resource links, and whether a trigger description looks weak, then scores 0-100. It never runs anything.
cold-run is the other half. It executes the skill and an agent that cannot see the skill, on the same task, and compares the artifacts.
| skill-doctor | cold-run | |
|---|---|---|
| Reads your skills | yes | yes |
| Runs them | no | yes |
| Catches a broken link or bad frontmatter | yes | no |
| Catches a skill that is well-formed and changes nothing | no | yes |
A skill can score 100/100 on structure and still be a no-op. That is the failure this catches, and it is the common one — 23 of my 47 were structurally perfect.
Run both. They fail on different things.
Prior art
obra/superpowers is the workflow layer — brainstorm,
plan, execute, verify. There is no overlap with this: zero workflow skills here, zero domain
checks there. Its writing-skills prescribes the same subagent testing this tool automates.
License
MIT.
Установить Cold Run в Claude Desktop, Claude Code, Cursor
unyly install cold-runСтавит в Claude Desktop, Claude Code, Cursor и VS Code — сам разбирается с npx, uvx и сборкой из исходников.
Впервые? Поставь CLI: curl -fsSL https://unyly.org/install | sh
Или настроить вручную
Выполни в терминале:
claude mcp add cold-run -- npx -y cold-runПошаговые гайды: как установить Cold Run
FAQ
Cold Run MCP бесплатный?
Да, Cold Run MCP бесплатный — установка в пару кликов через Unyly без оплаты.
Нужен ли API-ключ для Cold Run?
Нет, Cold Run работает без API-ключей и переменных окружения.
Cold Run — hosted или self-hosted?
Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.
Как установить Cold Run в Claude Desktop, Claude Code или Cursor?
Открой Cold Run на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.
Похожие MCP
Fetch
Web content fetching and conversion for efficient LLM usage.
AWS KB Retrieval
Retrieval from AWS Knowledge Base using Bedrock Agent Runtime.
автор: modelcontextprotocolSpring AI MCP Server
Provides auto-configuration for setting up an MCP server in Spring Boot applications.
llm-analysis-assistant
A very streamlined mcp client that supports calling and monitoring stdio/sse/streamableHttp, and can also view request responses through the /logs page. It also
автор: xuzexin-hzMCP-Agent
A simple, composable framework to build agents using Model Context Protocol by [LastMile AI](https://www.lastmileai.dev)
автор: lastmile-aiSpring AI MCP Client
Provides auto-configuration for MCP client functionality in Spring Boot applications.
mcp.natoma.ai
A Hosted MCP Platform to discover, install, manage and deploy MCP servers by [Natoma Labs](https://www.natoma.ai)
MCPHub
Website to list high quality MCP servers and reviews by real users. Also provide online chatbot for popular LLM models with MCP server support.
MCP Servers Rating and User Reviews
Website to rate MCP servers, write authentic user reviews, and [search engine for agent & mcp](http://www.deepnlp.org/search/agent)
mkinf
An Open Source registry of hosted MCP Servers to accelerate AI agent workflows.
Compare Cold Run with
Не уверен что выбрать?
Найди свой стек за 60 секунд
Автор?
Embed-бейдж для README
Похожее
Все в категории ai
