Content
86%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 lean skill body: every line is an instruction Claude could not infer, the delegation workflow is numbered with an explicit fallback for save location, and the short single-purpose scope needs no external references. The only minor gap is the absence of a post-completion verification step and a concrete example of launching the background agent.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is 13 lines with zero padding: it assumes Claude knows what a background agent or a Markdown file is and spends every token on instructions Claude could not infer ("每个 claim 都要追溯到拥有该事实的 source", "匹配现有 convention"). This matches the anchor 'lean and efficient; assumes Claude's competence; every token earns its place'; a 4 would require minor over-explanation to trim, which is absent. | 5 / 5 |
Actionability | For an instruction-only skill the guidance is concrete: enumerated source types ("official docs、source code、specs、first-party APIs"), a per-claim traceability rule, a specified output format (Markdown with per-claim source attribution), and a save-location rule with an explicit fallback ("如果没有 convention,就放在合理位置并说明路径"). It falls short of 5 because the agent-launch step is stated only as "启动一个 background agent" with no invocation example or output-note template, leaving a minor gap. | 4 / 5 |
Workflow Clarity | The three numbered steps are clearly sequenced (research against primary sources → write findings with sources → save to the repo's notes location), with a decision checkpoint for the no-convention case. It is not 5 because there is no validation/verification step (e.g., confirming the saved file's path back to the user or re-checking that every claim has a source) after the agent completes; it is well above 3 since the sequence is complete and includes fallback logic rather than having implicit gaps. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines, single-purpose, and has no bundle files (no references/, scripts/, or assets/ exist, and the body references none), so per the rubric's simple-skill guidance it can score 5 with well-organized content — which it has: a one-line purpose statement followed by an ordered three-item task list, with nothing inlined that belongs in a separate file. Not a 4, as there are no organization gaps or misplaced content. | 5 / 5 |
Total | 18 / 20 Passed |