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 exceptional operating reference: fully executable commands for every common case, explicit error-recovery loops, validation checkpoints before risky operations, and clean delegation of deeper detail to two real reference files and sibling skills. The only knock is minor over-explanation in a couple of rationale passages that could be tightened without losing information.
Suggestions
Trim the rationale sentences for pre-loosened agents and the shared-skills trust-boundary discussion down to one line each — the facts (microVM is the boundary; store is read-write and cross-sandbox) stand on their own.
The 'Last verified' section's caveats about dropped command blocks could be folded into the Known Discrepancies reference file to keep the main body purely operational.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with sbx-specific, non-inferable facts (deny-by-default egress, the `--` argument merge rule, create-time-only flags) and never explains concepts Claude already knows, so it is well above the 'mostly efficient' anchor. It falls short of 5 only because a few passages over-explain reasoning that could be trimmed — e.g. the rationale for pre-loosened agents ('The reasoning is that the microVM *is* the boundary, so the prompts guard nothing…') and the multi-sentence trust-boundary discussion of the shared skills store. | 4 / 5 |
Actionability | Nearly every section is copy-paste-ready shell commands with inline comments, covering the common cases concretely: lifecycle (`sbx run claude --name my-sandbox ~/my-project`), CI login (`echo "$DOCKER_PAT" | sbx login --username <docker-id> --password-stdin`), SSH commit signing, policy, ports, and the YAML kit fork example. This matches 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases'. | 5 / 5 |
Workflow Clarity | Multi-step processes are clearly sequenced with explicit validation checkpoints and feedback loops: SSH signing is split into 'Load the key on the **host**, then configure Git **inside**'; 'The loop' section is literally a validate-fix-retry cycle (`sbx policy log` → `sbx policy allow network <host>` → retry); and `sbx kit validate`, `sbx policy check`, `sbx skills import --dry-run`, and reading back OS-assigned ports from `sbx ports` serve as pre-flight checks. Diagnose commands are ordered ('Try them in that order'). | 5 / 5 |
Progressive Disclosure | The body is a clear 80%-case overview with well-signaled, one-level-deep references that exist on disk ([references/credentials.md](references/credentials.md), [references/discrepancies.md](references/discrepancies.md)), a 'Where the detail lives' routing table delegating deeper topics to named sibling skills, and no nested-reference chains. This matches 'Clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation'. | 5 / 5 |
Total | 19 / 20 Passed |