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, well-structured instruction skill: concrete tool calls, a complete URL lookup table, explicit retry/fallback loops, and pre-baked answers for the restart special case. Remaining gaps are minor — a duplicated fetch-first rule and no handling of a failed fetch call itself.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean and product-specific (URL table, restart recipe, workflow steps — none of it knowledge Claude already has), but "Always fetch the doc first — never answer from memory" appears twice (intro and Rules) and the Rules section partially restates the Workflow. Not 5 because of that duplication; not 3 since there is no padding or explanation of known concepts. | 4 / 5 |
Actionability | Everything needed to execute is concrete and copy-paste ready: a complete topic-to-URL table, an exact tool invocation ("web_fetch(url: \"<URL>\", max_length: 5000)"), intent-matching examples ("帮我打开webui" → web-server), a fully baked restart answer ("kill -USR1 $CLACKY_MASTER_PID"), and a terminal fallback message. Common cases are specifically covered. | 5 / 5 |
Workflow Clarity | The pick-URL → fetch → answer sequence is clear, with an explicit retry loop ("If the fetched page doesn't answer the question, try the next most relevant URL (max 2 fetches)") and a terminal fallback. Not 5 because the case where the web_fetch call itself fails (network or tool error) is not addressed — only the "page doesn't answer" case. | 4 / 5 |
Progressive Disclosure | The skill has no bundle files and is self-contained: sections are well-organized (Self-understanding, Doc URL Table, Workflow, Rules, Restart), external detail lives in runtime-fetched docs rather than inlined walls of text, and there are no nested references. Not 5 because at ~100 lines with the Rules section duplicating Workflow content, the structure could be tightened or the restart recipes split out. | 4 / 5 |
Total | 17 / 20 Passed |