Content
92%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 an exemplary lean operational guide: exact commands for the main clients, an explicit sign-in step, a verification gate, and targeted troubleshooting with recovery loops. The only notable gap is that six of the ten supported clients are handled by a generic instruction plus an external link rather than inline steps.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | "Server URL: ... Transport: Streamable HTTP. Auth: OAuth (PKCE, dynamic client registration)" and the terse per-client command blocks contain no concept explanations Claude already knows and no padding — every line is operational. Matches anchor 5: lean, assumes competence, every token earns its place. | 5 / 5 |
Actionability | Copy-paste-ready commands are given for Claude Code, Codex, Gemini CLI, and OpenCode (e.g. `claude mcp add --transport http openwork https://...`), with concrete sign-in and verification steps. The six remaining clients ("Cursor, VS Code, Claude Desktop, ChatGPT, Windsurf, Zed: add ... as a remote MCP server") get only a high-level instruction plus a docs URL rather than exact steps — a minor gap that fits anchor 4 rather than 5. | 4 / 5 |
Workflow Clarity | A clear three-stage sequence (Add → Sign in → Verify) with explicit validation checkpoints ("The agent has the search_capabilities and execute_capability tools") and a hard gate: "Don't claim the connection works until step 3 passes." The failure section adds a feedback loop (401/invalid_grant → log out and sign in again), matching the top anchor. | 5 / 5 |
Progressive Disclosure | Sections are well organized and content is appropriately placed: common clients inline with exact commands, niche clients deferred via a clearly signaled one-level-deep link ("Per-client steps: https://openworklabs.com/docs/start-here/connect-openwork-mcp"), plus a clearly labeled reference link. There is no bundled-file sprawl and no nested reference chains. | 5 / 5 |
Total | 19 / 20 Passed |