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.
The body is highly actionable with comprehensive, executable CLI commands and a clear connection workflow including error-recovery branching. Its main weaknesses are minor prose padding and inconsistent step numbering rather than structural problems.
Suggestions
Trim the intro paragraph and phrases like "so you can focus on the integration logic rather than auth plumbing" to tighten conciseness.
Fix step numbering so referenced steps ("Step 2", "1b") have matching labeled anchors, or relabel as a continuous numbered sequence.
Consider moving the proxy flags table and connection-state reference into a separate REFERENCE.md to improve progressive disclosure and reduce SKILL.md length.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is command-dense and mostly efficient, but the opening paragraph explaining what Reamaze is and prose like "so you can focus on the integration logic rather than auth plumbing" and "This will burn less tokens" are minor instances of over-explanation that could be trimmed. | 4 / 5 |
Actionability | It provides copy-paste-ready commands across install, login, connection ensure/get with polling, action list/run with JSON input, and proxy requests with a full flags table, covering the common cases fully and executably. | 5 / 5 |
Workflow Clarity | The install→auth→connect→search→run sequence is clear with a real state-based feedback loop (READY/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR polling), but step numbering is inconsistent ("skip to Step 2" with no labeled Step 2, a "1b" with no "1a") and output verification is implicit. | 4 / 5 |
Progressive Disclosure | The single SKILL.md is well-organized into clear sections with good navigation, but reference-style material (the proxy flags table, the connection-state breakdown) is inlined rather than split into a separate reference file, leaving minor organization gaps. | 4 / 5 |
Total | 17 / 20 Passed |