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, command-dense skill body that walks through auth, connection state handling, action discovery, execution, and proxying with copy-paste examples. Its weak spots are minor redundancy and an undefined "Step 2" reference in the workflow.
Suggestions
Define or remove the dangling "Step 2" references and renumber the connection steps (1b → 2) so the sequence is unambiguous.
Collapse the repeated action-discovery command in "## Popular actions" since it duplicates "### Searching for actions".
Trim the opening SkillzRun marketing paragraph to one line of relevant context.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean commands and short explanations, but the opening SkillzRun description paragraph and some repeated action-discovery commands ("## Popular actions" restates the list command) could be trimmed. | 4 / 5 |
Actionability | Nearly every section gives copy-paste-ready commands with concrete flags ("--json", "--wait", "--input '{\"key\": \"value\"}'") and a full proxy-option table, covering the common auth/connect/run/proxy cases. | 5 / 5 |
Workflow Clarity | The connect-to-poll-to-ready state machine is clearly sequenced with a feedback loop (poll after CLIENT_ACTION_REQUIRED), but references to an undefined "Step 2" and the loose "1b" sub-heading leave a minor gap. | 4 / 5 |
Progressive Disclosure | No bundle files exist; the single SKILL.md is well-organized into clear sections (Overview, Authentication, Connecting, Searching, Popular actions, Proxy, Best practices) with no nested references, though it runs longer than the simple-skill exception. | 4 / 5 |
Total | 17 / 20 Passed |