Content
70%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is well-structured with a clear, validation-gated workflow and honest handling of absent tooling. Its weaknesses are mild redundancy across sections and a lack of concrete executable examples for the python-pptx/OOXML operations it recommends.
Suggestions
Collapse the standalone "SharePoint Routing" and "Blocking Conditions" sections into the Core Workflow to remove duplication and shorten the body.
Add one short executable python-pptx snippet (e.g., clone a slide and replace text-bearing shapes) so the recommended edit strategy is copy-paste ready.
Show the exact fetch/update calls in context (e.g., `sharepoint.fetch(path, download_raw_file=True)` and `sharepoint.update_file(...)`) instead of naming them inline.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly lean and free of concepts Claude already knows, but SharePoint routing appears in Core Workflow steps 2/7/8 and again in its own "SharePoint Routing" section, and blocking/stop guidance is duplicated between step 8 and "Blocking Conditions" — it could be tightened. | 2 / 3 |
Actionability | Names concrete tools (python-pptx, lxml, Pillow, LibreOffice, Poppler) and operations (fetch(download_raw_file=true), update_file) with an ordered fallback strategy, but offers no executable code and leaves the python-pptx/OOXML mechanics at an abstract "use X for Y" level. | 2 / 3 |
Workflow Clarity | The 8-step Core Workflow is clearly sequenced with explicit validation checkpoints ("Perform visual QA", "compare the new slide to its neighbors") and stop conditions ("If style fidelity cannot be validated, stop"), backed by the Blocking Conditions list. | 3 / 3 |
Progressive Disclosure | A single self-contained file organized into well-labeled sections with no nested references; it explicitly and honestly states no helper scripts are bundled rather than implying missing files. | 3 / 3 |
Total | 10 / 12 Passed |