Content
82%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 strong, highly executable skill document: exact API calls with pitfalls, ready-to-run snippets, and a verification section. Its main weaknesses are mild redundancy between Procedure and the Quick Reference table, bulk lookup tables inlined rather than moved to references, and one bundled script (nutrition_search.py) that is not linked from the main file.
Suggestions
Reference `scripts/nutrition_search.py` from the Nutrition Lookup section (or remove it) — it exists in the bundle but is undiscoverable from SKILL.md.
Move the category/muscle/equipment ID tables into `references/ID_TABLES.md` and keep only a pointer, trimming the main file's token load.
Collapse the Quick Reference table or the inline endpoint listings — they duplicate each other; keep one source of truth.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely lean — no explanations of concepts Claude already knows, dense ID lookup tables explicitly justified as saving API calls ("so you don't need extra API calls"), and tight Pitfalls/Verification sections. It misses anchor 5 because of redundancy: the Quick Reference table repeats endpoints already shown in Procedure, and some Pitfall lines restate parameters already given inline. | 4 / 5 |
Actionability | Every workflow ships copy-paste-ready curl + Python snippets with exact query parameters, the offline calculators have exact CLI invocations (e.g. `python scripts/body_calc.py tdee <weight_kg> <height_cm> <age> <M|F> <activity 1-5>`), and pitfalls give concrete mitigations (add `language=2`, `status=2`, `sleep 2`). This matches anchor 5: fully executable, specific examples covering the common cases. | 5 / 5 |
Workflow Clarity | The exercise lookup is a clear numbered sequence (Step 1 identify → Step 2 reference IDs → Step 3 fetch and present), and a dedicated Verification section provides checkpoints with a sanity range ("TDEE should be 1500-3500"), plus rate-limit handling for batch requests — satisfying the batch-operations validation requirement. It falls short of anchor 5 because there are no error-recovery feedback loops (what to do when a query returns nothing or an API call fails). | 4 / 5 |
Progressive Disclosure | The body points to real, one-level-deep bundle files — `references/FORMULAS.md` ("See references/FORMULAS.md for the science behind each formula") and `scripts/body_calc.py`, both verified to exist — and sections are clearly organized. Minor gaps keep it from anchor 5: the large ID/equipment tables and Quick Reference are bulk reference data inlined in SKILL.md that could live in `references/`, and `scripts/nutrition_search.py` exists in the bundle but is never referenced from SKILL.md, hurting discoverability. | 4 / 5 |
Total | 17 / 20 Passed |