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 an extremely lean auto-generated thunk that delegates entirely to a shared skill outside the bundle. As a directive it is maximally concise and unambiguous, but it provides no overview of what the shared skill does and its single reference is an environment-dependent absolute path that does not exist in this environment, so the skill is not self-contained.
Suggestions
Add a one-line overview of the shared skill's core action (e.g., the `cmux workspace status set done` command and its skip conditions) so SKILL.md functions as an overview rather than a bare pointer.
Reference the shared skill via a bundle-relative path or bundle it under references/ so the skill is self-contained and portable, instead of the environment-dependent absolute path `~/.agents/skills/cmux-workspace-status/SKILL.md`, which does not resolve in this environment.
Provide a brief fallback for when the shared skill file is unavailable (e.g., inline the core command and skip conditions) so the directive remains actionable without the external dependency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is two lines — a generator comment and "Load and follow the shared skill at `~/.agents/skills/cmux-workspace-status/SKILL.md`" — with zero padding and no explanation of anything Claude already knows. Every token earns its place, matching the anchor-5 example of lean, competence-assuming content. | 5 / 5 |
Actionability | The single directive is concrete and executable as written (an exact path to load and follow), but the operational details — the actual `cmux workspace status set done` command and its conditions — live entirely in the external target with no inline summary or fallback. That minor gap keeps it below anchor 5's fully self-contained, copy-paste-ready guidance. | 4 / 5 |
Workflow Clarity | Per the simple-skill guideline, this is a single task with one unambiguous action ("Load and follow the shared skill at <exact path>"). The operation is neither destructive nor batch, so no validation cap applies, and there is no multi-step sequence to leave implicit. | 5 / 5 |
Progressive Disclosure | The body is a bare pointer with no overview content or sections, and its sole reference targets an absolute home-directory path outside the skill bundle (`~/.agents/skills/cmux-workspace-status/SKILL.md`) that does not resolve in this environment (the bundle has no references/, scripts/, or assets/). The reference is clearly signaled and only one level deep — above anchor 2 — but the absent overview and the unresolvable external dependency fall short of anchor 4's "good structure... minor organization gaps". | 3 / 5 |
Total | 17 / 20 Passed |