/evaluate:plugin-batch
Batch evaluate all skills in a plugin. Runs /evaluate:skill for each skill, then produces a plugin-level quality report.
When to Use This Skill
| Use this skill when... | Use alternative when... |
|---|---|
| Auditing all skills in a plugin before release | Evaluating a single skill -> /evaluate:skill |
| Establishing quality baselines across a plugin | Viewing past results -> /evaluate:report |
| Checking overall plugin quality after refactoring | Need structural compliance -> plugin-compliance-check.sh |
Context
- Available plugins: !
find . -maxdepth 2 -type d -name '*-plugin' -not -name '.claude-plugin'
Parameters
Parse these from $ARGUMENTS:
| Parameter | Default | Description |
|---|---|---|
<plugin-name> |
required | Name of the plugin to evaluate |
--create-missing-evals |
false | Generate evals for skills that lack them |
--parallel N |
1 | Max concurrent skill evaluations |
Execution
Step 1: Discover skills
Find all skills in the plugin:
<plugin-name>/skills/*/SKILL.md
List them and count the total.
Step 2: Filter and prepare
For each skill, check if evals.json exists:
- Has evals: include in evaluation
- No evals +
--create-missing-evals: include, will create evals during evaluation - No evals, no flag: skip with a note
Report the breakdown:
Found N skills in <plugin-name>:
- M with eval cases
- K without eval cases (skipped | will create)
Step 3: Run evaluations
For each included skill, invoke /evaluate:skill via the SlashCommand tool:
SlashCommand: /evaluate:skill <plugin-name>/<skill-name> [--create-evals]
If --parallel N is set and N > 1, batch evaluations into groups of N. Otherwise, run sequentially.
Report progress from the results themselves: after each /evaluate:skill
returns, state which skill finished and its pass rate from benchmark.json.
(Todo/task tools are not available on Opus 4.8+/Sonnet 5/Fable-generation
models unless CLAUDE_CODE_ENABLE_TODO_TOOLS=1 is set; do not depend on them
— see .claude/rules/agentic-permissions.md § Task-tool availability.)
Step 4: Aggregate plugin report
After all skill evaluations complete, read each skill's benchmark.json and aggregate:
bash evaluate-plugin/scripts/aggregate_benchmark.sh <plugin-name>
Write aggregated results to <plugin-name>/eval-results/plugin-benchmark.json.
Step 5: Report
Print a plugin-level summary table:
## Plugin Evaluation: <plugin-name>
| Skill | Evals | Pass Rate | Status |
|-------|-------|-----------|--------|
| skill-a | 4 | 100% | PASS |
| skill-b | 3 | 67% | PARTIAL |
| skill-c | 5 | 80% | PASS |
**Overall**: 82% pass rate across N eval cases
Rank skills by pass rate. Flag any below 50% as needing attention.
Agentic Optimizations
| Context | Command |
|---|---|
| Inventory plugin skills + evals | bash evaluate-plugin/scripts/inspect_eval.sh --plugin-dir <plugin> |
| Inspect a single skill's evals | bash evaluate-plugin/scripts/inspect_eval.sh --plugin <plugin> --skill <skill> |
| Aggregate results | bash evaluate-plugin/scripts/aggregate_benchmark.sh <plugin> |
Quick Reference
| Flag | Description |
|---|---|
--create-missing-evals |
Generate eval cases for skills without them |
--parallel N |
Max concurrent evaluations (default: 1) |