Content
42%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 provides real executable entry points and a clear sequenced workflow with a fallback, but it is weighed down by generic templated boilerplate and thin, non-specific domain guidance. Reference material exists but is barely substantive.
Suggestions
Remove or move generic boilerplate (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria) that does not advance CV-building, to tighten conciseness.
Replace the bare 'Features' list with concrete formatting rules and examples (section order, citation style, achievement phrasing) so the guidance is actionable.
Flesh out references/guidelines.md with real US medical CV standards and link to it by name from the body, or drop the reference if it adds no value.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is padded with templated boilerplate (Risk Assessment, Security Checklist, Lifecycle Status, Evaluation Criteria, Output Requirements) and repeats the description verbatim in 'When to Use'/'Key Features', adding generic process guidance Claude already knows, matching anchor 2. | 2 / 5 |
Actionability | Real executable commands (py_compile, running scripts/main.py) and a concrete input/output schema exist, but the core domain guidance ('Medical CV formatting', 'Achievement highlighting') is list-only with no specifics and main.py is a minimal toy, matching anchor 3. | 3 / 5 |
Workflow Clarity | A 5-step workflow with an explicit fallback loop and a Quick Check command is present, but validation checkpoints are largely implicit/abstract ('Validate that the request matches the documented scope'), matching anchor 3. | 3 / 5 |
Progressive Disclosure | A one-level-deep bundle exists (references/guidelines.md, scripts/main.py) and is generically signaled, but guidelines.md is a near-empty placeholder, references are not named or specifically linked, and much boilerplate is inlined, matching anchor 3. | 3 / 5 |
Total | 11 / 20 Passed |