Content
100%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 exemplar instruction-only skill: concise, fully executable, with a check-first workflow containing explicit failure branches and a fail-closed legacy path, all within a well-organized single file. No bundle files exist, yet nothing in the body references any, so disclosure is appropriately flat.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is imperative and dense throughout ("Run `ouroboros update --check`", "Never substitute a manual upgrade, and never infer ownership from `uv tool list`, `pipx list`, PATH order, directory names, or the active agent runtime") with zero padding or explanation of concepts Claude already knows. Every token carries skill-specific direction; matches the anchor 5 example of lean, competence-assuming content. | 5 / 5 |
Actionability | Every branch is fully executable with concrete commands: `ouroboros update --check`, `ouroboros update --yes`, `ouroboros update --yes --runtime all`, `ouroboros --version`, `ouroboros_session_status`, `/reload-plugins`, and `ooo setup`, covering up-to-date, update-available, check-failed, and legacy-install cases. This is copy-paste-ready guidance with specific examples for the common cases, matching anchor 5. | 5 / 5 |
Workflow Clarity | A clear 4-step sequence with explicit validation checkpoints: check-first before any change, defined error-recovery branches (check fails but help works → report native error and stop; help broken → fail-closed legacy path allowing only a read-only `--version`), and post-update verification by relaying the command's result. The explicit validate-then-act-with-fallback structure matches anchor 5; it is not anchor 4 because no meaningful checkpoints are missing. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines, self-contained, and needs no external references; sections are well-organized (command block, Instructions, footer spec) with extra options delegated to `ouroboros update --help` rather than inlined. Per the rubric's simple-skill exception, this scores 5. | 5 / 5 |
Total | 20 / 20 Passed |