Content
81%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 a dense, highly operational workflow with executable commands, validation checkpoints at every step, and explicit error-recovery and stop rules — workflow clarity is exemplary. Its only weaknesses are minor: a never-instantiated tool/arguments template and the inlined MCP handshake boilerplate that could be trimmed or extracted. Overall a strong skill body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is terse and imperative throughout ("Map the tool to code", "Packet and source first") with no explanations of concepts Claude already knows, and the domain caveats ("Target content language is not the authenticated account's UI language") are non-obvious and earn their place. It is not 5 because a few guardrails are repeated ("Do not invent a LinkedIn result", "do not invent one to complete the live check", "Do not create fake success or failure files") and the ~40 lines of generic MCP HTTP handshake boilerplate could be tightened or extracted; it is clearly above 3, which expects noticeable padding. | 4 / 5 |
Actionability | Nearly everything is copy-paste ready: the argument parser ("NUM=$(echo \"$ARGUMENTS\" | sed -E ...")"), "gh issue view $NUM --repo $REPO --comments", the port-picking and 30s startup-wait loop with failure tails, the curl initialize/initialized/tools/call sequence with session-id extraction, the jq meta-file capture, and the cleanup block. It is not 5 because the tool-call template ("TOOL=\"<TOOL>\"", "ARGS_JSON='{<ARGS>}'") is never instantiated with a worked example, leaving a minor gap in covering the common case. | 4 / 5 |
Workflow Clarity | The four-step sequence (Read the issue → Packet and source → Optional live check → Report) is explicit with validation at every stage: input validation with exit 1, "This step is complete when the report names the issue, the code SHA...", "If the workspace is dirty, ask before continuing", server-death and never-bound checks with log tails, session-id and protocol-error checks, and a fixed report template with a "Next" decision field. Error recovery and stop rules ("A protocol or validation error is an execution limit. Do not retry around it.") give it the feedback loops and checklist structure of anchor 5. | 5 / 5 |
Progressive Disclosure | No bundle files exist and the body is well-sectioned (## 1–4 plus "## Non-negotiables") so navigation is easy and nothing is buried. It does not reach 5: the skill exceeds the ~50-line simple-skill threshold and inlines content that could live one level deep, notably the generic MCP HTTP handshake boilerplate (initialize, session-id, notifications/initialized curl blocks) that is invariant across runs; it is well above 3, which expects inline content that clearly belongs elsewhere with weak signaling. | 4 / 5 |
Total | 17 / 20 Passed |