Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable with a clearly sequenced, well-validated workflow, but it is long for the context budget with recurring redundancy, and its progressive disclosure is undermined by references to bundle files that are not actually provided.
Suggestions
Dedupe the M-2 ghost-accumulation rule: state it once in §Ghost Discipline & Actor Lifecycle and have the Pitfalls table and Known Issues M-2 point to it instead of re-explaining the same guidance.
Provide the referenced bundle files (reference/decision-rules.md, reference/morph-helpers.py/.sh, reference/styles/INDEX.md, and the inherited skills/officecli-pptx/SKILL.md) or remove the dangling references so navigation targets are real.
Move the verbose Gate 5b jq/loop snippets and the full pitfall table into a reference file, leaving SKILL.md as a lean overview with one-level pointers.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Largely additive and good about deferring inherited material ('→ see pptx v2 §X'), but ~530 lines with notable redundancy — the M-2 ghost-accumulation rule and the per-slide re-ghosting guidance each recur across §Mental Model, §Ghost Discipline, the Pitfalls table, and Known Issues M-2 — so it could be tightened. | 2 / 3 |
Actionability | Provides fully executable, copy-paste-ready bash and python blocks with exact officecli commands and real props (e.g. `--prop 'name=!!scene-ring' --prop x=5cm`), jq readback snippets, and concrete raw-set examples — no pseudocode. | 3 / 3 |
Workflow Clarity | Clear pre-code sequence (Setup → Help-First → pair-planning table → recipes) with explicit validation checkpoints in the Delivery Gate (Gate 1–5b OK/REJECT, COUNT-then-if/else pattern) and feedback loops (REJECT → fix → re-run) for batch/destructive operations. | 3 / 3 |
Progressive Disclosure | References are well-signaled in prose ('→ see pptx v2 §X', a References section), but the actual bundle directories (reference/, scripts/, assets/) and the cited files (decision-rules.md, morph-helpers.py, styles/INDEX.md, skills/officecli-pptx/SKILL.md) are not present in the bundle, and the ~530-line body keeps Gate loops, recipes, and pitfalls inline where they could be split. | 2 / 3 |
Total | 10 / 12 Passed |