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.
A highly actionable, well-sequenced command spec whose four modes each carry executable bash and explicit validation loops. Its weaknesses are a dangling runner.sh reference, some redundant prose sections, and zero progressive disclosure across files.
Suggestions
Define or scaffold runner.sh (it is referenced in --scaffold's next steps but never created), or replace the reference with the inline loop instructions already present in Mode 3.
Move 'The pattern (background)' section and the program.md minimal-structure template into a references/ file (e.g. references/pattern.md) to slim SKILL.md to the operational core.
Add an explicit error-handling step in the Mode 3 cycle for measure.sh failing or returning a non-integer (it runs with `set -euo pipefail`).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dominated by executable commands and templates, but 'The pattern (background)' comparison table, the 'Key insight' paragraph, and the closing Usage section (which duplicates the mode headers and $ARGUMENTS) are trimmable padding. | 4 / 5 |
Actionability | Every mode ships copy-paste-ready bash (metric greps, loop detection, status checks) and concrete file templates. The gap: `--scaffold`'s next steps instruct `bash scripts/autoresearch/runner.sh {loop-name} 0 15`, but runner.sh is never scaffolded or defined anywhere. | 4 / 5 |
Workflow Clarity | Each mode is numbered with prerequisite checks, and Mode 3 has an explicit feedback loop (measure -> apply -> re-measure -> KEEP/REVERT) that validates every destructive change. Minor gaps remain: no handling if measure.sh fails mid-loop (it uses `set -euo pipefail`) and no post-scaffold verification. | 4 / 5 |
Progressive Disclosure | A single monolithic ~290-line SKILL.md with no bundle files at all. Sections are clearly headed, but the background/pattern section and the program.md template are inline content that belongs in a separate reference file. | 3 / 5 |
Total | 15 / 20 Passed |