Content
92%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a lean, opinionated style guide with executable Gherkin templates, concrete good/bad step examples, an anti-patterns table with fixes, and an explicit coverage workflow with a done-when checklist. Its only trimmable content is the basic Gherkin syntax skeleton that restates what Claude already knows.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The Rules and Anti-patterns sections are dense with non-obvious, project-specific judgment ("A UI Then is scored by Jev against the accessibility tree"), but the Structure section's basic Gherkin skeleton (Feature/Background/Given/When/Then) largely restates syntax Claude already knows and could be trimmed. This matches anchor 4's minor instances of over-explanation rather than anchor 5's every-token-earns-its-place. | 4 / 5 |
Actionability | The body provides complete, copy-adaptable Gherkin templates for both a plain scenario and a Scenario Outline with an Examples table, plus concrete good/bad pairs ("When the customer submits the order" — never "When I click \"#submit-btn\"") and a Fix column in the anti-patterns table. Guidance is fully executable and covers the common cases. | 5 / 5 |
Workflow Clarity | This is not a destructive or batch operation, so no cap applies. The Coverage section defines the process ("Work from the list of use cases and edge cases, not from intuition"), includes an explicit feedback loop ("A case with no scenario is a gap to report, not a case to silently drop"), and ends with a validation checklist ("**Done when** every case maps to at least one scenario, each scenario has exactly one When and an observable Then"). | 5 / 5 |
Progressive Disclosure | The skill is self-contained (~50 non-blank lines) with no external references needed, and content is well-organized into clearly navigable sections (Structure, Rules, Anti-patterns, Coverage). Per the simple-skill exception, well-organized sections with no need for external references score 5. | 5 / 5 |
Total | 19 / 20 Passed |