Content
71%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.
The body is a generated redirect stub: maximally lean, but its only instruction points to a shared skill that is not present in the bundle or on the filesystem, so the skill carries no usable content of its own. Structure is trivially simple rather than well-organized progressive disclosure — the entire content lives one unresolvable hop away.
Suggestions
Inline a minimal summary of the worktree convention (the ~/.worktrees/<path-key>/<branch> layout, the dotfiles-repo opt-in, and known limitations) directly in SKILL.md, or ship the shared content as a bundle file under references/ so the skill remains usable when the external path is absent.
Make the referenced path verifiable — either relative to the skill bundle or accompanied by a fallback note explaining what to do if ~/.agents/skills/using-git-worktrees/SKILL.md is unavailable.
Remove or contextualize the "Generated by scripts/agent-harnesses.py; do not edit directly" comment, since no such script ships with this bundle and it adds a dangling reference for readers.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is two lines — a provenance comment and a single pointer instruction — with no padding, no explanation of concepts Claude already knows, and nothing to trim. Every token earns its place, matching the lean-and-efficient anchor exactly. | 5 / 5 |
Actionability | The one instruction is concrete ("Load and follow the shared skill at ~/.agents/skills/using-git-worktrees/SKILL.md"), but the referenced file does not exist — neither in the bundle (no references/, scripts/, or assets/ directories) nor on disk — so executing the load step dead-ends. There is no inlined guidance and no fallback, leaving the guidance concrete but incomplete; it is below the 4 anchor's 'minor gaps' and above the vague/abstract anchors. | 3 / 5 |
Workflow Clarity | The single action is unambiguous (load a specific file, then follow it), which under the simple-skill note could score 5 — but there is no checkpoint or fallback for the case where the referenced shared skill is unresolvable, which is a real gap here. It fits the 4 anchor: clear sequence with a minor gap. | 4 / 5 |
Progressive Disclosure | The single reference is clearly signaled and one level deep, but it points outside the bundle to a file that is absent, and the body's "Generated by scripts/agent-harnesses.py" mentions a script that is not in the bundle either. With zero overview content inlined, the SKILL.md is an empty shell whose one hop leads nowhere — matching the 'some structure but references unresolvable / could be better organized' band more than the 4 anchor's 'minor organization gaps'. | 3 / 5 |
Total | 15 / 20 Passed |