Content
85%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 delegation stub: maximally concise, with one unambiguous, executable instruction. However, it delegates all substantive content to an external absolute path outside the skill's bundle, which does not resolve here, leaving the skill with no in-bundle materials and a single point of failure for navigation.
Suggestions
Ship the shared skill content as a bundle-relative reference (e.g. references/worktree-convention.md) or vendor a copy inside the skill directory so the SKILL.md reference resolves within the bundle itself.
Add a one-line fallback for when '~/.agents/skills/using-git-worktrees/SKILL.md' is absent (e.g. 'If missing, ask the user where the shared skills directory lives') so the redirect is not a dead end.
State what 'follow' concretely means (read the file and apply it as this skill's instructions) so harnesses that cannot auto-load external paths still know the exact next step.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is two lean lines — 'Load and follow the shared skill at `~/.agents/skills/using-git-worktrees/SKILL.md`' plus a generator comment — with zero padding and no explanation of concepts Claude already knows. Every token earns its place. | 5 / 5 |
Actionability | 'Load and follow the shared skill at `~/.agents/skills/using-git-worktrees/SKILL.md`' is a concrete, executable directive with an exact path, so an agent knows precisely what to do. Not 5 because it covers only the single redirect case with no fallback guidance if the target file is absent; not 3 because the instruction as written is complete and specific rather than missing key details. | 4 / 5 |
Workflow Clarity | A single unambiguous action (load and follow the shared skill), which the simple-skill exception says can score 5. No destructive or batch operations are described in the body, so the validation cap does not apply. | 5 / 5 |
Progressive Disclosure | The bundle contains no reference/asset/script files, and the sole referenced path is an absolute home-directory path ('~/.agents/skills/using-git-worktrees/SKILL.md') that does not resolve in this environment, so navigation cannot be verified against a real file. The reference is clearly signaled but points entirely outside the skill's own structure with an empty bundle — structure exists but organization is questionable, fitting anchor 3 rather than 4's 'only minor organization gaps'. | 3 / 5 |
Total | 17 / 20 Passed |