skill-eval

Benchmark Claude Code skill revisions with isolated runs and statistical grading.

89|7|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/nikhilsitaram/claude-caliper --skill skill-eval-nikhilsitaram
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-eval
Source: https://github.com/nikhilsitaram/claude-caliper/tree/main/skills/skill-eval
Command: npx skills add https://github.com/nikhilsitaram/claude-caliper --skill skill-eval-nikhilsitaram

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Skill-eval helps you verify whether a Claude Code skill actually changes behavior, so you can catch regressions, measure flakiness, and compare revisions with evidence instead of intuition.

Core Features & Use Cases

  • Snapshot a skill before editing so you have a baseline for comparison.
  • Run realistic prompts against before and after versions with multiple runs per eval.
  • Grade each response with cited evidence, then aggregate pass rates, timing, and variance.
  • Use blind comparison and post-hoc analysis to understand why one version performs better.
  • Apply it when a skill feels inconsistent, when you are refining instructions, or when you want to prove a new skill adds value.

Quick Start

Use the skill-eval workflow to snapshot the target skill, create a few realistic eval prompts, run before-and-after benchmarks, and review the grading and comparison results.

Frequently Asked Questions about skill-eval

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

FAQPage Schema
How do I benchmark Claude Code skills to detect regressions before shipping?

To benchmark Claude Code skills and detect regressions, you can snapshot a skill before editing to establish a baseline, then run realistic prompts against before and after versions with multiple runs per eval. The process uses isolated claude -p runs and assertion-based grading to produce reproducible results.

What is skill evaluation and how does blind comparison work for Claude Code?

Skill evaluation measures and compares Claude Code skill behavior to detect regressions and improvement gaps. Blind comparison works by grading responses with cited evidence, then aggregating pass rates, timing, and variance to understand why one version performs better without bias.

How do I measure flakiness and variance in Claude Code skill responses?

You measure flakiness and variance in Claude Code skill responses by running multiple isolated claude -p executions against realistic prompts. The skill applies statistical aggregation to pass rates and timing data, producing reproducible benchmark results that highlight inconsistency.

Can I use assertion-based grading to validate new Claude Code skills?

Yes, you can use assertion-based grading to validate new Claude Code skills. The skill-eval workflow allows you to create realistic eval prompts, run before-and-after benchmarks, and grade each response with cited evidence to prove a new skill adds value.

What is the best way to compare before and after versions of a Claude Code skill?

The best way to compare before and after versions of a Claude Code skill is using isolated runs, statistical aggregation, and post-hoc analysis. This approach snapshots the baseline, applies realistic prompts, and generates reproducible benchmark results with evidence.

Why does my Claude Code skill feel inconsistent and how do I analyze it?

If your Claude Code skill feels inconsistent, you can apply skill-eval for variance analysis. It runs isolated benchmarks, grades responses with cited evidence, and uses post-hoc analysis to identify flakiness and understand the root causes of behavioral regressions.