Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a strong, actionable CLI reference with concrete commands and a clear inspect-then-call workflow, held back from a perfect score only by the verbose Credential handling prose.
Suggestions
Tighten the Credential handling section: consolidate the successive 'Do not...' clauses into a short bulleted list of rules so the guidance stays actionable without the prose padding.
Collapse the repeated explanations that --config is the credential-bearing source of truth into a single stated rule, since the same point is made across two paragraphs.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The command reference sections are lean, but the Credential handling section runs to dense multi-clause prose with repeated 'Do not...' guidance and re-explained --config/source-of-truth points that could be tightened, fitting the score-2 'mostly efficient but could be tightened' anchor rather than 'every token earns its place'. | 2 / 3 |
Actionability | Provides fully executable, copy-paste-ready commands across every section (e.g. 'mcporter call linear.list_issues team=ENG limit:5', 'mcporter --config path/to/skill/mcp.json list <server> --schema --output json'), matching the score-3 anchor for concrete, specific examples. | 3 / 3 |
Workflow Clarity | The durable-skill workflow is a clear, unambiguous sequence — 'first inspect the server schema' then 'call the selected tool with explicit arguments' — where the schema inspection acts as the checkpoint; for this simple workflow the scoring note permits a 3 without an elaborate validate/retry loop. | 3 / 3 |
Progressive Disclosure | Content is well-organized into clearly labeled sections (Quick start, Call tools, Auth + config, Daemon, Codegen, Notes) with no nested references; as a self-contained CLI cheat-sheet it needs no external file splits, satisfying the well-organized-sections allowance. | 3 / 3 |
Total | 11 / 12 Passed |