Content
75%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 executable CLI commands and a solid connect-and-poll workflow, but it carries some padding in the intro and asides and could split its detailed reference material into bundle files.
Suggestions
Trim the opening marketing paragraph and "rather than auth plumbing"-style asides to assume Claude's competence.
Fix the step numbering (define explicit Step 1 / Step 2 headers instead of a lone "1b" and a referenced-but-unlabeled "Step 2").
Move the clientAction state-machine detail and proxy flag table into a references/ file, leaving SKILL.md as a concise overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The bulk is lean executable commands, but the opening marketing paragraph ("improving user experience"), the "rather than auth plumbing" aside, and the bare "Use action names and parameters as needed" line add unnecessary explanation that could be trimmed. | 3 / 5 |
Actionability | Copy-paste-ready bash commands cover install, login, connection ensure/get, action list/run, and proxy requests, plus a concrete flag table — fully executable across the common cases. | 5 / 5 |
Workflow Clarity | A clear install→auth→connect→search→run sequence exists with a state-checking feedback loop (poll until READY, handle CLIENT_ACTION_REQUIRED, re-poll), but the "1b" / "Step 2" numbering is inconsistent and some checkpoints are implicit. | 4 / 5 |
Progressive Disclosure | The single file is well-sectioned with clear headers and an external official-docs link; with no bundle files present, structure is appropriate, though the detailed clientAction state machine and proxy flag table could live in separate reference files. | 4 / 5 |
Total | 16 / 20 Passed |