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.
An exemplary CLI skill body: nearly every line is an executable command, default, or constraint, with a golden path that includes dry-run validation and detach/reattach recovery. The only deductions are version-pinned model names scattered outside a deprecated section and a single-file layout that could offload some secondary detail to reference files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and imperative with essentially no explanation of concepts Claude already knows — every section is commands, defaults, or constraints. It is penalized one notch because time-sensitive version information ("GPT‑5.2 Pro", "gpt-5.2-pro") appears throughout rather than in a deprecated/old-patterns section, and a few sections (remote browser host, exhaustive prompt pattern) run slightly long; anchor 4 rather than 5. | 4 / 5 |
Actionability | Guidance is fully executable and copy-paste ready: complete commands like `npx -y @steipete/oracle --engine browser --model gpt-5.2-pro -p "<task>" --file "src/**"`, `oracle status --hours 72`, and exact mkdir/redirect recipes for the manual fallback. Defaults, excludes, and hidden flags are all specified concretely, matching anchor 5. | 5 / 5 |
Workflow Clarity | The "Golden path" gives a clear numbered sequence with an explicit pre-send validation step ("Preview what you're about to send (`--dry-run` + `--files-report`)"), token-budget checkpoints, and an error-recovery loop for the main failure mode ("If the run detaches/timeouts: reattach to the stored session (don't re-run)" with the reattach commands). This matches anchor 5's sequence + checkpoints + feedback loop. | 5 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent) and the single SKILL.md is well-organized with clear section headers covering one coherent topic, so there are no buried or nested references. It falls just short of anchor 5 because at ~115 lines, secondary material (remote browser host setup, the exhaustive-prompt pattern, session management details) could arguably live in one-level-deep reference files — minor organization gaps place it at 4. | 4 / 5 |
Total | 18 / 20 Passed |