Content
71%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 concise, well-sequenced instruction body for a simple single-purpose skill, with sensible decision branching and no token waste. Its weaknesses are executable specificity — the central script call has no invocation syntax and no file backing it — and bundle integration, since the one provided reference file is never surfaced.
Suggestions
Show the exact script invocation in step 3 (e.g., `python scripts/check_price.py --price "$164.95" --budget 200.00`) and ship the script at that path so the instruction is copy-paste executable.
Reference the bundled reference file where relevant, e.g., in step 2: "See [price_patterns.md](references/price_patterns.md) for common price string formats and budget phrasings".
Add a brief note on handling edge cases the script might report (multiple prices, malformed price strings) or unexpected script errors, to round out the decision workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is ~19 lean lines with no explanation of concepts Claude already knows; every line either gives a process step or an operational note ("Do not perform manual price parsing or comparison", "If the price cannot be found... continue your search"). This matches the score-5 anchor (lean, assumes competence, every token earns its place) and clearly beats the score-4 anchor, which requires over-explanation to trim. | 5 / 5 |
Actionability | Step 3 says "Run the `check_price.py` script, providing it with the extracted price string and the budget" but never shows the actual command — no script path, no argument format, no example invocation — and the bundled `scripts/` directory does not exist, so the instruction cannot be executed as written. This fits the score-3 anchor (some concrete guidance but incomplete, missing key details); it is not score 4 because the core action lacks an executable form, and not score 2 because the steps, inputs, and expected output are otherwise specific. | 3 / 5 |
Workflow Clarity | The Process section gives a clear four-step sequence (identify budget → locate price → run check → decide) with explicit True/False branches and a missing-price fallback in Notes, which serves as a checkpoint for the main failure mode. It matches the score-4 anchor (clear sequence, most checkpoints present, minor gaps); it is not score 5 because there is no guidance for handling script errors or ambiguous output, and not score 3 because both decision branches and the not-found case are addressed. | 4 / 5 |
Progressive Disclosure | The body itself is well-organized with clear Process/Notes sections, but scored against the actual bundle it has real organization gaps: the bundled `references/price_patterns.md` (useful budget phrasings and price formats) is never mentioned or linked from the body, and the referenced `check_price.py` has no corresponding file in the bundle. This matches the score-3 anchor (structure present, references present but not clearly signaled); the under-50-line simple-skill exception would allow a 5, but an orphaned reference file plus a dangling script reference is more than a minor gap. | 3 / 5 |
Total | 15 / 20 Passed |