Content
71%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 highly actionable and clearly sequenced, with real commands, real code, and exact configuration flags grounded in actual source files. Its weaknesses are token efficiency and structure: internal implementation and protocol-versioning detail, repeated guidance, and large policy sections are inlined in SKILL.md instead of being offloaded to reference files like the one well-signaled reference that already exists.
Suggestions
Move internal implementation and spec detail (the A2A_SECRET/JWT `jti` paragraph, the MCP 2026-07-28 / RFC 9207 / Client ID Metadata Documents prose, and the per-client config file paths in §5) into reference files like the existing references/mcp-apps-embedding.md, keeping SKILL.md to the actionable steps.
Deduplicate guidance stated multiple times: the `link` purity contract appears in Rule, §2, Do, and Don't, and the `npx … connect` command appears three times — state each once and cross-reference.
Give 'See the Blueprint Installer doc' a concrete path or link, and consider splitting the long §1a catalog/exposure-policy prose into its own reference so the main body stays a navigable overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Most content is dense, framework-specific guidance Claude could not know, but there is a noticeable amount that could be trimmed: internal implementation detail ('a logged-in browser session mints an `A2A_SECRET`-signed JWT carrying the caller's `sub` + `org_domain` and a unique `jti`'), time-sensitive spec prose ('MCP `2026-07-28`', '2025-era clients', RFC 9207, Client ID Metadata Documents) not placed in a deprecated/old-patterns section, and repetition (the `link` purity contract appears in Rule, §2, Do, and Don't; the `npx … connect` command appears three times). This sits between anchor 2's 'several unnecessary explanations or padded sections' and anchor 4's 'minor instances of over-explanation' — mostly efficient but needs tightening. | 3 / 5 |
Actionability | Guidance is fully executable across the common cases: copy-paste commands ('npx @agent-native/core@latest connect https://dispatch.agent-native.com', 'pnpm exec agent-native mcp install --client claude-code|…|github-copilot'), real code for the `link` builder, `mcpApp`/`embedApp()`, and `callMcpTool` (grounded in actual files like 'templates/mail/actions/manage-draft.ts'), and exact config flags ('MCPConfig.builtinCrossAppTools: false', 'externalAgents.authenticatedReads: "auto"', 'mcpApp.compactCatalog: true'). This matches anchor 5; the only elisions ('// …schema, run…') are deliberate and standard. | 5 / 5 |
Workflow Clarity | The How section is clearly sequenced (1 connect → 1a verbs → 1b fast-path → 2 link builder → 2a MCP Apps → 3 open route → 4 ingest → 5 local dev), with a numbered 4-step sequence for the open route and diagnostic/recovery guidance ('A sparse or empty `tools/list` is diagnostic…', 'reconnect the Claude connector or rescan/review the ChatGPT connector', 'validate with a fresh tool call'). Anchor 5 would require validation checkpoints embedded in each workflow with explicit feedback loops, whereas here they live mostly in the Do/Don't lists, so anchor 4 ('clear sequence with most checkpoints present; minor validation gaps') is the best fit. | 4 / 5 |
Progressive Disclosure | The bundle has exactly one reference (references/mcp-apps-embedding.md), and it is clearly signaled with a read-trigger ('Read it before changing the `embedApp()` shell …'), one level deep. However, the ~540-line body inlines substantial material that belongs in reference files — MCP protocol-version/OAuth validation internals, provider API connector policy, per-client config file paths, catalog/exposure policy — matching anchor 3's 'content that should be separate is inline', and 'See the Blueprint Installer doc' has no path or link. It is better organized than anchor 3's example but clearly short of anchor 4's 'most content is appropriately placed'. | 3 / 5 |
Total | 15 / 20 Passed |