Content
92%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.
A well-engineered process skill: two clearly sequenced modes with explicit validation gates, re-validation after repair, and strong safety guardrails around destructive edits, backed by real, purpose-signaled reference files. The only weakness is minor conceptual framing in the intro that could be tightened.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational (tables for stages, statuses, and severity; terse rules like 'Never prune what a model cannot absorb'), but the opening conceptual framing — 'An agent without a flywheel is limited to a single session: what it learns ends when the session does' and 'Every harness records sessions and stores context differently' — is motivational context that could be trimmed. This matches the 4 anchor (efficient with minor instances that could be trimmed) rather than 5 (every token earns its place); the Katz citation does earn its place since the concept is niche. | 4 / 5 |
Actionability | Guidance is fully executable: exact discovery command (`git ls-files ':(glob)**/*flywheel*.md' ...`), exact evidence commands (`git log -1 --format=%cs -- <path>`, `python3 ~/scripts/harness-sessions.py <slugs> --since <N> --json`, `command -v`, `just --list`), and copy-paste templates for the review report, Cycle log row, pointer section, and charter row. This matches the 5 anchor; nothing is pseudocode or left at the hint level. | 5 / 5 |
Workflow Clarity | Both modes are numbered procedures with explicit validation and feedback loops: review step 2 specifies path/command/hook/recency checks, step 6 gates all changes on a user answer ('Change nothing before the answer'), and step 8 reruns the checks after repair. Destructive operations are explicitly guarded ('Never remove a scaffold without an ablation result', 'Never overwrite a flywheel doc', never edit permission-defining files — write a patch instead). This matches the 5 anchor's explicit validation steps and error-recovery loops. | 5 / 5 |
Progressive Disclosure | All referenced bundle files exist (references/stages.md, references/harness-signals.md, references/setup-prompts.md, assets/flywheel-template.md), are one level deep, and each reference is signaled with its purpose and read timing ('Read it before judging or proposing any stage'). The split is appropriate: procedures and report formats live in SKILL.md while per-stage evidence checks, harness specifics, and setup prompts live in references — matching the 5 anchor's clear overview with well-signaled one-level-deep references. | 5 / 5 |
Total | 19 / 20 Passed |