Content
85%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 well-structured, docs-first workflow with a sequenced build process, explicit validation ladder, and excellent progressive disclosure into real, conditionally-signaled reference files. The main gaps are mild redundancy in reference pointers and the absence of any inline code snippet for the most common scaffold case.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, imperative, and assumes Claude's competence — it never explains what MCP or a widget is. Minor inefficiencies remain: each reference file is pointed to both inline ('Read references/... when ...') and again in the final References section, and a few bullets are wordy, so it is 'efficient with minor trimming possible' rather than fully lean. | 4 / 5 |
Actionability | Concrete, executable guidance throughout: exact doc paths ('apps-sdk/build/mcp-server'), a real script ('scripts/scaffold_node_ext_apps.mjs'), specific APIs ('window.openai.callTool(...)'), the MIME type 'text/html;profile=mcp-app', the ngrok command, and the exact Settings path for Developer Mode. Falls short of the top anchor only because there is no copy-paste-ready code snippet in the body itself for the most common scaffold case — code lives in the script and references. | 4 / 5 |
Workflow Clarity | A clearly sequenced workflow (steps 0–9) with explicit validation checkpoints: a lowest-cost-first validation ladder, 'If doc search times out... fetch the canonical Apps SDK pages directly and continue', 'If you are only delivering a scaffold... say exactly what you did not run', and a minimum working repo contract checked before considering work done — including explicit what-was-and-was-not-run reporting. | 5 / 5 |
Progressive Disclosure | The body is an overview that pushes detail into 7 one-level-deep reference files plus 1 script, all of which exist on disk. Each is clearly signaled inline with a 'Read references/X.md when...' condition plus a consolidated References section, making navigation easy. No nested references or inlined bulk content. | 5 / 5 |
Total | 18 / 20 Passed |