Content
70%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 highly actionable, well-sequenced workflow with explicit validation checkpoints and fix-and-retry feedback loops, grounded in exact tool names and parameters. Its main weaknesses are the monolithic Presentations paragraph, which should be split into a reference file and deduplicated against steps 4–5, and the absence of any literal example calls.
Suggestions
Move the Presentations guidance (animation, inspect/check flow, present server, exports) into a references/presentations.md file and keep a concise routing bullet inline pointing to it, e.g. "Presentations: use document.slidev.create; see PRESENTATIONS.md for animation, check, present and export details."
Break the remaining format bullets into sub-bullets and deduplicate verification guidance between the Presentations bullet and steps 4–5 so each rule appears once.
Include one concrete example per major format (a minimal echarts.render options JSON or a minimal slides.md skeleton) to make the guidance copy-paste ready and lift actionability to 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Almost every clause is actionable rather than explanatory, but the Presentations bullet is a ~1,800-character run-on paragraph ("Treat the scaffold as editable... omit that archive unless requested") mixing authoring, animation, verification, presenting and export policy, and verification requirements are repeated between the bullet and steps 4–5. Mostly efficient, but more than minor tightening is needed, so it sits below anchor 4. | 3 / 5 |
Actionability | Concrete tool names and parameters appear throughout ("document.echarts.render", "document.typst.compile", "format=docx", "require scope=full, complete=true and ok=true", "content.sections[].images with caption and altText"), with concrete success criteria. It falls short of anchor 5 because no literal call examples or code snippets are given — argument structures must be inferred from the tools' own schemas. | 4 / 5 |
Workflow Clarity | A clear numbered 1–6 sequence (establish criteria → choose tool → author → inspect → reconcile/fix → attach) with explicit validation gates ("Run `inspect`, then `check`", "Render PDF pages with `readPdf` and compare layout with supplied references") and fix-and-retry feedback loops ("fix missing content or layout defects before delivery", "A provider's success response alone is not a quality check"). This matches anchor 5's explicit validation, feedback loops and checklist-like coverage. | 5 / 5 |
Progressive Disclosure | No bundle files exist (no references/, scripts/ or assets/), so all guidance is inline; the ~1.8KB Presentations sub-workflow (animation, checks, present server, exports, ZIP handling) clearly belongs in a separate reference file with a one-line pointer. The per-format routing and numbered steps give some structure, but content that should be separate is inline, matching anchor 3. | 3 / 5 |
Total | 15 / 20 Passed |