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 procedural skill body: fully executable commands, a clearly sequenced workflow with validation and stop conditions at every step, and lean prose that explains only non-obvious domain facts (Electron has no install script, the allowScripts key must be hand-updated). The only minor cost is a version-stamped npm-gating digression in step 4 that could be shortened.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and imperative with well-justified rationale (e.g. why --save-exact is required, why the lockfile must be committed), but step 4 inlines a time-sensitive research digression ("Verified on 42.10.1 and 42.11.0; re-check with npm view electron@<NEW_VERSION> scripts...") that could be trimmed. It is not 5 because version-specific verification details are not in a deprecated/old-patterns section; it is well above 3 because nearly every other token earns its place. | 4 / 5 |
Actionability | Every step is fully executable with copy-paste-ready commands (git branch --show-current, npm install --save-dev --save-exact electron@<NEW_VERSION>, cat node_modules/electron/dist/version, npx --no-install install-electron, npm test), and the <NEW_VERSION> parameter is explicitly defined up front in the Arguments section. | 5 / 5 |
Workflow Clarity | A clear 7-step sequence with explicit validation checkpoints at each step: verify the starting branch and stop if not main, confirm the npm install exit code, verify the exact pin in package.json and the lockfile, confirm the on-disk binary version before running tests, and stop on test failures with a defined final report. This matches the anchor's feedback loops and stop-on-failure recovery. | 5 / 5 |
Progressive Disclosure | This is a single-purpose procedural skill (~90 lines) whose entire content belongs in SKILL.md: clean numbered sections, no reference nesting, no bundle files, and no content that would be better split into a separate file. It is above anchor 4 because there are no organization gaps — every section is task-essential and easy to navigate. | 5 / 5 |
Total | 19 / 20 Passed |