Content
86%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.
A well-structured, token-efficient overview for a single-purpose tool skill: verified executable commands covering the main usage variants, clear activation triggers, and clean section organization with no unnecessary padding. The main improvement opportunities are folding the redundant 'Key Concept' section into the intro and adding a dry-run-first checkpoint for the costly batch execution.
Suggestions
Fold the 'Key Concept: Prompt Independence' section into the intro's strictness-levels line instead of restating it as a separate section, trimming redundant tokens.
Add a validation checkpoint for the costly batch run, e.g., 'Validate setup first with --dry-run (no cost) before running a full compliance pass'.
Note where reports are written (default results/<skill-name>.md) so the agent knows where to read the output after a run.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence — no explanations of known concepts, just tool-specific facts. One minor trimmable redundancy: the 'Key Concept: Prompt Independence' section ('Measures whether a skill/rule is followed even when the prompt doesn't explicitly support it') restates what the intro's 'scenarios with decreasing prompt strictness (supportive → neutral → competing)' already conveys. Efficient with minor over-explanation fits level 4 rather than level 5's 'every token earns its place'. | 4 / 5 |
Actionability | The Usage section provides three copy-paste-ready commands covering the common cases — full run ('uv run python -m scripts.run ~/.claude/rules/common/testing.md'), dry run ('--dry-run'), and custom models ('--gen-model haiku --model sonnet') — all verified to exist in scripts/run.py. This matches the level-5 anchor (fully executable, specific examples covering common cases), not level 4 which implies missing details. | 5 / 5 |
Workflow Clarity | The agent workflow (activation triggers in 'When to Activate' → unambiguous run command in 'Usage') is a clear, single-action sequence, and the intro's 6-step pipeline explains what the tool does. However, a full run is a batch, cost-incurring operation (multiple agent executions at 3 strictness levels) and the body never suggests validating with the zero-cost '--dry-run' first — a minor validation gap that fits level 4 rather than level 5's explicit checkpoints. | 4 / 5 |
Progressive Disclosure | The body is ~50 lines with well-organized sections (Supported Targets, When to Activate, Usage, Report Contents, Advanced) and needs no external references; the one path it does reference (the scripts.run module) resolves to a real bundle file (scripts/run.py). Per the simple-skill guideline (under 50 lines, no need for external references), this earns level 5 with well-organized sections alone. | 5 / 5 |
Total | 18 / 20 Passed |