Content
100%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: lean, dense with non-obvious operational knowledge, fully executable commands, and three clearly sequenced workflows with explicit validation and error-recovery guidance. Bundle references align exactly with the on-disk structure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section carries operational facts Claude would not know (the `.md` suffix trick, the uncommitted-mirror copyright rationale, the lock-diff review mechanism, the shared-filename resolution gotcha) with no padding or explanations of known concepts. Time-sensitive dates are confined to a dedicated "## Last verified" section where the date is the content itself. | 5 / 5 |
Actionability | Commands are copy-paste ready: `curl -s https://docs.docker.com/ai/sandboxes/customize/kit-reference.md`, `skills/finding-sbx-docs/scripts/fetch-docs.sh`, `git diff -- skills/finding-sbx-docs/references/docs.lock`, `sbx --version`, and `sbx <cmd> --help`, plus concrete numbered procedures for lookup and claim-checking. | 5 / 5 |
Workflow Clarity | Each workflow (find the page, check a claim, carry a change) is an ordered sequence with stop conditions, and the batch "carry a change" workflow has explicit validation: the lock diff defines the batch, "Done means every changed page is accounted for" is the checklist, and failure modes come with recovery guidance (re-fetch rather than re-relink; suspect the mirror before believing the diff). | 5 / 5 |
Progressive Disclosure | The body is a navigable overview whose referenced paths — `scripts/fetch-docs.sh`, `scripts/relink-docs.py`, `references/docs.lock`, and the script-generated `references/docs/README.md` and `.fetched` — are one level deep, clearly signaled, and match the actual bundle (the deliberately uncommitted mirror's absence is explicitly explained). The page-to-skill ownership table provides navigation to the rest of the family. | 5 / 5 |
Total | 20 / 20 Passed |