Content
75%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.
A highly actionable, well-structured instruction skill: every command is concrete and executable, and error-recovery guidance (PATH fallback, search-before-add, ask-before-install) is present. The main cost is redundancy — the 'Key facts' section duplicates five points already stated, inflating token spend without adding information.
Suggestions
Delete or drastically trim the 'Key facts' section: all five bullets repeat earlier sections (install check, devbox.json location, PATH-inside-run-only, prefer run over shell, first-run slowness) — state each fact once in its own section.
Fold the detection/install/run steps into one short numbered sequence at the top so the end-to-end workflow is visible at a glance instead of implied across sections.
Consider moving the Services and Global packages sections (situational, less common) into a single 'Beyond one-off commands' section or a reference file to shorten the always-loaded body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean and operational, but the 'Key facts' section restates five points already made verbatim-earlier ('check with `command -v devbox` and install via curl', 'devbox.json may live in the repo root or a subdir root', 'Prefer `devbox run` over `devbox shell`', 'first run ... can be slow'). That duplication is more than 'minor instances that could be trimmed', so it fits the 3 anchor rather than 4; it is not a 2 because no space is spent explaining concepts Claude already knows. | 3 / 5 |
Actionability | Every section gives copy-paste-ready commands: `command -v devbox`, the curl install one-liner, `ls devbox.json 2>/dev/null || find . -maxdepth 2 -name devbox.json`, `devbox run psql "$MASTER_DB_URL" -c 'SHOW wal_level;'`, `devbox search`/`devbox add`, and `devbox services ls/up/stop`. The examples cover the common cases with real invocations, matching the 5 anchor. | 5 / 5 |
Workflow Clarity | There is a clear implicit sequence (detect devbox.json → check installed → install with error recovery for PATH → run) and a numbered decision list for binary sourcing with a `devbox search` checkpoint and a user-confirmation gate before `devbox add`. It is a 4 rather than 5 because the steps are spread across sections with no single end-to-end sequence and some checkpoints (e.g. confirming devbox.json exists before running) are implicit; it is above 3 because checkpoints and error-recovery guidance are present. | 4 / 5 |
Progressive Disclosure | The body is well-organized into clearly signaled sections (When to reach for it, Check it's installed, How to run, Project scripts, Services, Discovering more) with no bundle files, so nothing is buried or nested. It scores 4 rather than 5 because at ~119 lines it exceeds the simple-skill threshold and carries the duplicated 'Key facts' section that should either be merged into the body or split out — a minor organization gap, not the structural problems of a 3. | 4 / 5 |
Total | 16 / 20 Passed |