Content
77%Reviews 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 body with executable code and built-in validation feedback loops, held back slightly by repetition across sections and a large amount of reference-grade content kept inline rather than progressively disclosed to bundle files.
Suggestions
Dedupe the host/client enumeration and Dispatch URL — define the client list and connector URL once in the Rule, then reference them from How/Do instead of repeating.
Move the verbose builtin-verb catalog (list_apps/open_app/ask_app/etc.) and per-host setup detail into a references file to lift progressive_disclosure and shrink the inline body.
Tighten the compact-catalog/auth-policy paragraph (section 1a) into a short rule plus a reference, since it currently re-explains the same policy across several sentences.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence (no primers on MCP/OAuth), but the client enumeration and Dispatch URL recur across the Rule, How, and Do sections, and ~510 lines could be tightened — placing it at 'mostly efficient but could be tightened' rather than fully lean. | 2 / 3 |
Actionability | Provides fully executable, copy-paste-ready guidance: real `buildDeepLink`/`embedApp`/`callMcpTool` code, exact `npx @agent-native/core@latest connect` commands, and precise config paths (.mcp.json, ~/.claude.json, ~/.codex/config.toml). | 3 / 3 |
Workflow Clarity | The numbered How section (1, 1a, 1b, 2, 2a, 3, 4, 5) sequences the work and embeds explicit validation/feedback loops — "validate with a fresh tool call", reconnect/rescan on stale descriptors, sparse `tools/list` as a diagnostic, and test-after-shell-change guidance. | 3 / 3 |
Progressive Disclosure | One reference is clearly signaled and real ("**`references/mcp-apps-embedding.md`**. Read it before changing..."), but the ~510-line body keeps large reference-grade material (verb catalog, per-host setup, connector internals) inline rather than split into the single available bundle file. | 2 / 3 |
Total | 10 / 12 Passed |