Content
92%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 workflow skill body: lean, densely prescriptive, correctly ordered with validation gates, feedback loops, and safety exclusions, and structured as an overview that delegates each source of truth to a clearly labeled one-level-deep link. The only shortfall is a couple of delegated or under-specified steps (PR base verification, the routine-path fragment) that keep actionability just short of fully copy-paste ready.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~55-line body is dense and rule-bearing throughout — e.g. 'A move is atomic: remove from the old home, add to the new home, and fix every inbound link in the same change' and 'Exclude .agents/notes/archived/ from corpus audits and edits'. It assumes Claude's competence (no explanation of what Markdown or budgets are), delegates the standard itself to linked sources ('read, don't re-summarize'), and contains no padding or restated basics, matching 'lean and efficient; every token earns its place'. | 5 / 5 |
Actionability | Mostly executable, copy-paste-ready commands: 'pnpm run verify-doc-budgets --list', "git ls-files '*.md' ':(exclude)vendor/**' | xargs wc -w | sort -rn | head -30", 'pnpm run doc-sync', 'pnpm run lint', 'git diff --check', 'pnpm run verify-translation-pairing --write <pair>'. Minor gaps keep it below anchor 5: 'Verify and fetch the PR's live base' gives direction without a command, and steps like the 'lightweight routine path' and 'relocate-condense-raise policy' are delegated to fragments in docs/AGENTS.md rather than stated inline. This sits between anchors 4 and 5, noticeably above the midpoint but not fully self-contained. | 4 / 5 |
Workflow Clarity | The process is explicitly ordered — structural pass ('Apply the standard's authoring order'), then 'After the structural pass, hunt the standard's slop checklist', then 'Validation and PR hygiene' — with numbered steps inside each phase. Risky batch operations (doc moves, corpus-wide edits) have pre-validation ('Before renaming or moving any doc, grep for inbound references'), a feedback loop ('After a retarget or base merge, rerun the report and audit prose introduced by the new base'), a safety exclusion for the frozen archive, and a failure path section ('When verify-doc-budgets goes red'). This matches 'clear sequence with explicit validation steps; feedback loops for error recovery'. | 5 / 5 |
Progressive Disclosure | The body is a workflow overview that pushes the standard itself to clearly signaled, one-level-deep references with per-link purpose descriptions: 'docs/AGENTS.md — hierarchy, tutorial/reference forms, taxonomy, budgets, and slop checklist', '.agents/notes/README.md — when a decision earns an Agent Note', 'docs/i18n/README.md — the bilingual pairing rules', plus three sibling skills. No content that belongs in a separate file is inlined and no reference is nested, matching 'clear overview with well-signaled one-level-deep references; easy navigation'. No bundle files exist in this skill directory, so the structure is the SKILL.md body itself. | 5 / 5 |
Total | 19 / 20 Passed |