Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A concise, well-sequenced workflow with a useful retry loop, but its actionability and progressive disclosure are undermined by a referenced script that is missing from the bundle and an existing reference file that is never linked from the body.
Suggestions
Either add the missing parse_query.py to a scripts/ directory and show its exact invocation (e.g., `python scripts/parse_query.py "<instruction>"`), or replace the script step with explicit inline parsing instructions so the action is fully executable.
Link the existing references/query_components.md from the body (e.g., under Procedure or a References section) so the attribute/price-pattern reference is discoverable, and remove or fix the dangling parse_query.py reference to match the actual bundle.
Add a brief verification checkpoint confirming extracted price limits are numeric ranges before issuing the first search, which would tighten the already-present review step.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~30-line body is lean and well-sectioned (When to Use, Core Task, Procedure, Output, Notes) with no padding explaining concepts Claude already knows; every section earns its place, matching the level-3 lean-and-efficient anchor. | 3 / 3 |
Actionability | Provides some concrete guidance (example output dict {'product': 'popcorn', ...} and example search[gluten free popcorn]), but the core step 'Execute the bundled script parse_query.py' gives no executable invocation and the referenced script does not exist in the bundle, fitting the level-2 anchor of some concrete guidance but incomplete with missing key details. | 2 / 3 |
Workflow Clarity | The three-step Procedure is clearly sequenced (Run parser -> Review & Refine -> Formulate Search Strategy) and includes an explicit error-recovery feedback loop in Notes ('If the initial search yields no results, consider broadening the search by removing less critical attributes one at a time'), matching the level-3 anchor of a clear sequence with feedback loops for error recovery. | 3 / 3 |
Progressive Disclosure | The body sections are well organized, but the bundle is misaligned: the body references parse_query.py which does not exist, while the existing references/query_components.md is never linked or signaled from the body, fitting the level-2 anchor of some structure but references present yet not clearly signaled. | 2 / 3 |
Total | 10 / 12 Passed |