Content
88%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 deliberately minimal, generated stub that cleanly delegates to a shared canonical skill — maximally concise and unambiguous, but entirely dependent on an out-of-bundle file. Structure and clarity are good; the only weaknesses are the total absence of inline guidance and a dangling generator-script reference.
Suggestions
Add a one-to-two line summary of the flywheel loop's core stages (record → learn → apply → prune → tune) so the skill remains actionable if `~/.agents/skills/flywheel/SKILL.md` is missing on the user's machine (addresses actionability).
Resolve the dangling `scripts/agent-harnesses.py` reference — either ship the generator in the bundle's `scripts/` directory or drop the path from the comment — so all referenced paths exist (addresses progressive_disclosure).
Consider noting what to do when the shared skill is absent (e.g., fall back to the description's define/review/repair workflow) to close the fallback gap (addresses actionability).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is two lines — a provenance comment ("Generated by scripts/agent-harnesses.py; do not edit directly") and a single redirect instruction — with zero padding and no explanation of concepts Claude already knows. Every token serves a purpose, matching the lean score-5 anchor; there is nothing to trim, so score 4 does not apply. | 5 / 5 |
Actionability | "Load and follow the shared skill at `~/.agents/skills/flywheel/SKILL.md`" is a concrete, immediately executable instruction with a specific path, so it clears the mostly-executable score-4 anchor. It falls short of score 5 because all substantive guidance is delegated to an external file with no in-bundle content, no coverage of common cases, and no fallback if that path is absent. | 4 / 5 |
Workflow Clarity | This is a single-task skill and its one action — load and follow the named shared skill file — is unambiguous, which per the simple-skill guideline earns a 5. No destructive or batch operations are involved, so the validation-cap rule is not triggered. | 5 / 5 |
Progressive Disclosure | The single reference to `~/.agents/skills/flywheel/SKILL.md` is clearly signaled and one level deep with nothing inlined that belongs elsewhere, giving good structure. Minor gaps keep it from a 5: the referenced path is external to the bundle and unverifiable from it, and the comment cites `scripts/agent-harnesses.py` although no `scripts/` directory exists in the bundle. | 4 / 5 |
Total | 18 / 20 Passed |