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.
A strong operational skill body: routing is unambiguous, commands are exact and verified against the bundle, and validation/checklist discipline is exceptional. The main cost is length — several sections carry reference-grade detail inline that dilutes the overview role of SKILL.md.
Suggestions
Move the tool-evidence mode's exhaustive selector/exit-code/coverage semantics and the four-step Kimi home-discovery procedure into dedicated files under references/, leaving a one-line route plus the key gating rule in SKILL.md.
Trim the dated war story ('战例(2026-09-18)') to its distilled heuristics — the three numbered criteria already capture the rules; the anecdote duplicates them as narrative.
Consolidate the per-mode exit-code semantics (0/1/2) scattered across sections into one small table so each section only states its own deviations.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with hard operational facts (exit codes, byte caps, copy-divergence gates) rather than padding about known concepts, but sections like the Kimi home-discovery procedure, the tool-evidence flag/exit-code semantics, and the dated '战例(2026-09-18)' anecdote run long and could be tightened or externalized. It sits above 'noticeably verbose' (2) but carries more than 'minor' over-length, matching 'mostly efficient but could be tightened' (3). | 3 / 5 |
Actionability | Every route resolves to an exact, copy-paste-ready command ('scripts/read_claude_session.py --session <ID> --tool-evidence --contains <literal>', 'python3 scripts/skill_usage_ledger.py index'), all of which exist in scripts/, with expected outputs and exit-code semantics stated per mode. This matches the 'fully executable, copy-paste ready, specific examples cover the common cases' anchor; it is not level 4 because no route leaves the executor guessing at flags or arguments. | 5 / 5 |
Workflow Clarity | The routing table maps each user intent to a specific command, and multi-step flows carry explicit validation: recovery runs a report first and writes 'only after the user asked to recover content', the negative-claims section imposes a pre-assertion checklist, and readers 'fail visibly' on divergent copies with prescribed retry ('repeat only this read'). This matches 'clear sequence with explicit validation steps; feedback loops for error recovery; checklists for complex processes'; the destructive-operation cap does not apply because the write path is validated. | 5 / 5 |
Progressive Disclosure | All six referenced files exist in references/ and are one level deep with purpose-conditioned pointers ('Read references/session_file_format.md when interpreting schemas...'), and the nine bundled scripts are real. It falls short of 5 because the SKILL.md body itself inlines substantial reference-grade detail (tool-evidence selector semantics, the four-step Kimi home-location procedure) that belongs in a bundled reference, keeping it at 'good structure; most content appropriately placed; minor organization gaps'. | 4 / 5 |
Total | 17 / 20 Passed |