skill-benchmark

Benchmark Claude Code skills against baselines using controlled eval sessions.

155|24|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/workersio/spec --skill skill-benchmark-workersio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-benchmark
Source: https://github.com/workersio/spec/tree/main/plugins/skill-benchmark/skills/skill-benchmark
Command: npx skills add https://github.com/workersio/spec --skill skill-benchmark-workersio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables teams to rigorously evaluate whether a Claude Code skill improves agent performance compared to a baseline, using controlled evaluation sessions and objective grading.

Core Features & Use Cases

  • Layered grading: deterministic checks first, then LLM-as-judge to produce robust scores.
  • Isolated sandbox per session: clean state per run to reduce interference.
  • Multi-run evaluation: runs to account for non-determinism and compute pass@k metrics.
  • Negative controls: out-of-domain tasks to detect false positives and ensure reliability.
  • Auto task generation and config support: optional config.yml to customize models, tasks, and runs, with default fallbacks.
  • Detailed outputs and metadata: response.json, transcript.json, meta.json, and behavior.json for deep analysis.
  • Security considerations: explicit prompts and isolation to maintain safety.

Quick Start

Run /skill-benchmark to start benchmarking a target skill against a baseline.

Frequently Asked Questions about skill-benchmark

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I benchmark Claude Code skills against a baseline?

Multi-run benchmarking executes tasks repeatedly to account for non-determinism, using isolated sandboxes per run to reduce interference. It applies layered grading with deterministic checks and LLM-as-judge scoring to produce robust performance metrics.

How does LLM-as-judge scoring work for skill evaluation?

LLM-as-judge scoring evaluates skill performance after deterministic checks are applied, providing objective grades on response quality and behavior. This layered approach ensures robust scoring by combining automated validation with language model assessment.

Can I use negative controls to detect false positives in skill benchmarks?

Yes, negative controls use out-of-domain tasks to detect false positives and ensure reliability. By running benchmarks against tasks the skill should not solve, you can verify that performance improvements are specific to the intended domain.

Do I need a config.yml to customize task generation for sandbox evaluation?

No, a config.yml is optional. It allows you to customize models, tasks, and runs, but the benchmarking tool provides default fallbacks for task generation and configuration if no config file is supplied.

What artifacts are generated for reproducible skill grading?

Reproducible skill grading generates detailed artifacts including response.json, transcript.json, meta.json, and behavior.json. These files capture outputs, conversation history, metadata, and behavioral analysis for deep evaluation and reporting.