Content
77%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
Highly actionable with strong validation checkpoints, but verbose and monolithic — it leans on internal incident IDs Claude can't expand and keeps substantial reference-grade material inline rather than in bundled files.
Suggestions
Move the multi-worktree port-offset table, WORKTREE_PORT_OFFSET derivation, and sidecar handling into a references/ file (e.g. PORT-OFFSET.md) and link to it from SKILL.md to improve progressive disclosure and reduce inline bulk.
Replace or inline-resolve the opaque incident/feature IDs (F073, F102, F182, F193, LL-015) with a one-line plain-language summary, since Claude cannot look them up; this trims tokens and removes dead context.
Consolidate the repeated 🔴 prohibitions into a single 'Forbidden actions' list to cut redundancy without losing the safety signal.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with concrete commands, but padded by repeated 🔴 warnings and opaque internal incident/feature IDs (F073, F102, F182, F193, LL-015) that Claude cannot resolve, and a large port-offset table that could be tightened. | 2 / 3 |
Actionability | Fully executable bash snippets, a concrete .env template, exact port numbers, and copy-paste-ready validation commands (pnpm test, pnpm check:worktree-port-offset). | 3 / 3 |
Workflow Clarity | Clear sequenced flow (recall → sync check → create → verify → cleanup) with explicit validation checkpoints (ahead=0/behind=0, baseline test, pre-remove branch-merged check) and a safety checklist covering destructive ops. | 3 / 3 |
Progressive Disclosure | Well-sectioned and single-level (no nested references), but monolithic: the multi-worktree port-offset table, sidecar design, and commit-footer details are inline content that could be split into reference files, and the one design reference is explicitly removed. | 2 / 3 |
Total | 10 / 12 Passed |