Content
93%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.
An exemplary skill body: dense with non-obvious, project-specific gotchas, fully executable commands for every mode, and clean delegation of MCP and mock-server detail to accurate one-level-deep references. The only gap is the absence of an explicit validate-and-recover step when a test run misbehaves.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence — it spends every token on non-inferable, project-specific knowledge ("--model alone won't switch providers — --auth-type does", "the footer placeholder Type your message is always rendered — don't grep for that", "respond_in_schema under request.tools[0] — not under response_format") with no padding or explanation of concepts Claude already knows; even the API payload example is explicitly marked "Trimmed structure". | 5 / 5 |
Actionability | Fully executable, copy-paste-ready commands cover the common cases: headless invocation with concrete flags, a working jq filter for tool-result errors (jq '.[] | select(.type=="user") | .message.content[] | select(.is_error)'), the full tmux launch/send-keys/wait/capture sequence, QWEN_RUNTIME_DIR redirection, --openai-logging invocation, and token-stats.py usage — with the <qwen> placeholder defined up front. | 5 / 5 |
Workflow Clarity | Sequencing is clear and decision-first (which binary → run mode → inspecting → tips), and each mode is stepwise (launch → send → wait → capture → cleanup) with genuine checkpoints like polling for "esc to cancel" and filtering is_error results. It falls short of anchor 5 only in lacking an explicit recovery loop for failed runs (e.g., what to check when a headless run emits no result element), and the waiting/checkpoint guidance that does exist is spread across sections rather than consolidated. | 4 / 5 |
Progressive Disclosure | SKILL.md keeps the core run-modes inline and delegates whole subtopics via well-signaled, one-level-deep references whose previews match the actual files (verified present with real content): references/mcp-testing.md and scripts/mcp-test-server.js, references/mock-openai-server.md and scripts/mock-openai-server.js, plus scripts/token-stats.py — no nesting, easy navigation. | 5 / 5 |
Total | 19 / 20 Passed |