# Skill Benchmark Rubric

Use this scorecard to quantify how much active skills improve implementation quality.

## 1. Eval-Driven Scorecard

**Source your scorecard from `evals/evals.json`, not from hardcoded patterns.**
For each active P0/P1 skill relevant to the selected file:

| Skill          | P-Level | Failure Pattern (from `not_contains` assertions / Anti-Patterns) | Success Pattern (from `contains` assertions) |
| :------------- | :------ | :--------------------------------------------------------------- | :------------------------------------------- |
| _[skill name]_ | P0/P1   | _[anti-pattern or not_contains value]_                           | _[expected assertion value]_                 |

## 2. Iteration Table (Root Cause Analysis)

For every `❌ FAIL` in the benchmark, identify the root cause:

| Failure            | Root Cause                 | Fix                                         |
| :----------------- | :------------------------- | :------------------------------------------ |
| Skill ignored      | Trigger not matching file  | Refine `packages`/`files` in registry       |
| Rule too vague     | Anti-pattern unclear       | Add `**No X**: Do Y.` line to SKILL.md      |
| Pattern missing    | No reference code          | Add to `references/` folder                 |
| Skills conflict    | Two skills contradict      | Ensure P0 overrides P1                      |
| Missing evals      | No `evals/evals.json`      | Create evals with ≥3 prompts, ≥2 assertions |
| Low eval alignment | SKILL.md missing key terms | Add missing assertion values to SKILL.md    |

## 3. Compliance Score Calculation

- **Before Score**: `(Matches / Total Assertions) * 100` = **X%**
- **After Score**: `(Matches / Total Assertions) * 100` = **Y%**
- **Δ Delta**: **+Z%** 🚀
