Content
88%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 and workflow-rich, with executable commands, a clearly sequenced connection state machine, and good section structure; only minor conciseness trimming is warranted.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely efficient with ready-to-run commands and flag tables, but minor padding remains (the 'focus on integration logic rather than auth plumbing' aside and the opening paragraph explaining what MoDeck is). | 4 / 5 |
Actionability | It provides copy-paste-ready commands for every key operation (login, connection ensure, polling, action list/run, proxy requests) with flags and JSON examples covering the common cases. | 5 / 5 |
Workflow Clarity | The connection flow is explicitly sequenced with state-based polling checkpoints (READY/BUILDING/CLIENT_ACTION_REQUIRED/CONFIGURATION_ERROR) and a feedback loop directing the agent to re-poll after the user completes an action. | 5 / 5 |
Progressive Disclosure | The single-file skill is well-organized into clearly headed sections (Overview, Working with MoDeck, Authentication, Connecting, Searching actions, Running actions, Proxy requests, Best practices) with no nested references, though it exceeds the under-50-line simple-skill exception. | 4 / 5 |
Total | 18 / 20 Passed |