Content
93%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 skill body for a code-scaffolding task: dense, project-specific, and fully executable, with details correctly pushed into three conditionally-loaded reference files. The only weakness is that the two verification steps don't include an explicit fix-and-retry loop, leaving workflow clarity just short of the top anchor.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence: no explanation of what ESLint or ASTs are, just decision tables, file paths, and templates. Every section adds information Claude cannot infer (shared utility locations, plugin registration specifics, autofix policy), matching the 5-anchor 'every token earns its place'. It does not fit the 4-anchor because there is no over-explanatory padding to trim. | 5 / 5 |
Actionability | Fully executable guidance throughout: exact file paths for rule and spec files, copy-paste TypeScript rule/test templates, concrete test commands ('pnpm test-ci "static/oxlint/eslintPluginScraps/src/rules/$ARGUMENTS.spec.ts"'), registration snippets for both the rules index and eslint.config.ts, and explicit naming conventions. Not a 4: there are no minor gaps — the common cases (no-options rule, fixable rule) are covered end to end. | 5 / 5 |
Workflow Clarity | Clear four-step sequence (choose archetype → check utilities → create files → register) with explicit validation checkpoints (run the test command after creating the rule and again after registration). It falls short of the 5-anchor because feedback loops for error recovery ('if tests fail, fix and re-run') are not spelled out — verification is present but the retry path is implicit. Above the 3-anchor since checkpoints are explicit, not missing. | 4 / 5 |
Progressive Disclosure | Clean overview-plus-references structure: the archetype table routes to the right reference conditionally, schema-patterns.md is loaded only 'if your rule needs configurable options', and all three referenced files exist and are one level deep with clear 'load this reference when' signaling. Matches the 5-anchor; the body keeps only templates and decisions inline while detail lives in references. Not a 4: navigation and placement are unambiguous. | 5 / 5 |
Total | 19 / 20 Passed |