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 instruction-only skill body: a lean, fully executable fetch-and-apply workflow with exact URLs, a worked example, robust fail-closed error handling, and real progressive disclosure to remote cards plus a correctly scoped snapshot reference. The only flaw is a handful of trimmable justification clauses that keep conciseness just short of perfect.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence (no explanation of what lockfiles or security are), with every section operational ("Fetch `https://securitycards.rewarelabs.com/llms.txt`", "Take the exact installed version from the lockfile"). A few justification clauses could be trimmed ("— guidance differs between releases", "even when you already know which category you need"), so it fits the 4 anchor (efficient with minor trimmable instances) rather than the every-token-earns-its-place 5. | 4 / 5 |
Actionability | Fully executable: exact endpoints, a concrete fetch command ("a shell fetch such as `curl -fsS <url>`"), the catalog line format `<library> <version> <prefix> <category>...`, URL construction rules, and a worked example (the flask line yielding `.../flask/3-1-3/output-encoding.md`). This is copy-paste-ready instruction guidance covering the common case, matching the 5 anchor; as an instruction-only skill, the absence of code is not penalized per the rubric's scoring notes. | 5 / 5 |
Workflow Clarity | A clearly sequenced workflow (resolve version → find cards → choose what to read → apply) with explicit validation checkpoints: the fail-closed section enumerates error paths (missing version, ambiguous normalization, redirect landing check, unreachable site), and the before-finishing checklist requires re-running tests, citing card URLs, and reporting unsupported dependencies separately. This matches the 5 anchor (clear sequence, explicit validation, error-recovery feedback loops, checklist). | 5 / 5 |
Progressive Disclosure | The SKILL.md is a genuine index and workflow ("This skill is an index and a workflow, not an offline security knowledge base"), with detail pushed one level away to remote cards fetched on demand. The single bundle file, `references/catalog.json`, exists on disk, is clearly signaled in the body, and its role is precisely scoped (a packaged-day snapshot usable only to report whether a dependency was supported, never as a source of rules). Well-organized sections make navigation trivial, matching the 5 anchor. | 5 / 5 |
Total | 19 / 20 Passed |