Content
82%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.
A highly actionable, well-structured CLI skill body with copy-paste commands and a clear inspect-then-call workflow. Its main gaps are a missing validation/recovery checkpoint in the main workflow and references to bundle files that don't exist.
Suggestions
Add an explicit validation/verification step to the durable-skill workflow (e.g., after calling a tool, check the JSON output for an error field and retry with corrected args before proceeding).
Either create the referenced bundle files (mcp.json, references/, scripts/) or reword the 'Skill-first MCP shape' section so it does not read as a pointer to files that are absent.
Tighten the credential-handling bullets into shorter imperative sentences to improve token efficiency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean command lists and sectioned guidance that assumes Claude's competence (no explanation of what MCP or a CLI is); the credential-handling bullets are wordy with long compound sentences that could be tightened, keeping it just below the 'lean/every token earns its place' anchor. | 4 / 5 |
Actionability | It provides copy-paste-ready, fully executable commands across the common cases — schema inspection, tool calls with selector/function/URL/stdio/JSON variants, auth, config, daemon, and codegen — matching the 'fully executable; covers common cases' anchor. | 5 / 5 |
Workflow Clarity | The durable-skill workflow gives a clear, justified two-step sequence ('first inspect the server schema... Then call the selected tool with explicit arguments'), but it lacks an explicit validation/verification checkpoint or recovery loop, so it sits below the 5 anchor. | 4 / 5 |
Progressive Disclosure | The body is well-organized into clear sections (Skill-first MCP shape, Credential handling, Quick start, Call tools, Auth + config, Daemon, Codegen, Notes) and self-contained; however, the references/scripts/mcp.json structure it describes does not exist as actual bundle files, so the signaled navigation is conceptual rather than real, keeping it below the 5 anchor. | 4 / 5 |
Total | 17 / 20 Passed |