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 lean command reference: fully executable commands, concrete measured rationale for the tricky env-copy pipeline, explicit safety guidance around destructive remove/install operations, and well-organized single-file structure. The only gap is the absence of an explicit post-create verification step in the workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and every token earns its place: it conveys only non-obvious, repo-specific knowledge (gitignored-file behavior, measured timings "~11s vs ~0.1s", the STORE_ENCRYPTION_KEY trap in setup-env-files.js) and never explains concepts Claude already knows. It is not 4 because there are no sections that could be trimmed without losing decision-relevant information. | 5 / 5 |
Actionability | Commands are copy-paste ready and cover the common cases: `git worktree add -b <branch> <worktree-path>`, the `git ls-files -z -o -i --exclude-standard --directory | rsync -a --from0 --files-from=-` pipeline, and the --lite loop. The only pseudocode, `sanitize(BRANCH)`, is immediately defined ("lowercase; `/` → `-`"), so this fully matches the executable anchor. | 5 / 5 |
Workflow Clarity | Sections follow a logical create→inspect→copy→remove sequence with real checkpoints ("Abort if `WORKTREE` already exists", "report the list that was sent", "use `--force` only when the user explicitly asks" guarding the destructive remove). It is not 5 because there is no explicit post-create verification step or error-recovery loop, and not 3 because validation guidance for the risky operations is explicitly present. | 4 / 5 |
Progressive Disclosure | This is a ~100-line single-use reference correctly kept in one file with well-organized sections and no content that belongs in a separate file; navigation is easy and cross-references to sibling skills (nv-worktree-create, nv-worktree-cleanup) are clearly signaled. There are no bundle files to misplace, and nothing is buried. | 5 / 5 |
Total | 19 / 20 Passed |