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.
The body is an exemplary thin-wrapper skill: fully executable commands, an explicit load-validation checkpoint, and concrete error-recovery branches for every failure mode. The only notable deduction is time-sensitive version troubleshooting embedded in the main flow rather than isolated in a deprecated-versions section.
Suggestions
Move the glab/Orbit CLI minimum-version troubleshooting (v1.94.0, v1.117.0, v0.126.0-v0.130.x) into a clearly labeled "Troubleshooting / old versions" section, or trim the version-range detail, since it is time-sensitive and partially duplicates the frontmatter compatibility field.
Tighten the fallback paragraph — "If the block above is not a skill... run `glab orbit skills get orbit`" repeats the command the `!` line already invokes — into a single sentence covering the case where auto-execution does not render a skill block.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence (no concept explanations, every sentence adds non-obvious setup knowledge), but it embeds time-sensitive version numbers ("glab v1.94.0 or later", "v0.126.0 to v0.130.x") outside any deprecated/old-patterns section, and these partially duplicate the frontmatter compatibility field — a direct penalty trigger under the rubric's version-number guideline, so it cannot be a 5. | 4 / 5 |
Actionability | All guidance is fully executable and copy-paste ready — "!`glab orbit skills get orbit`", "orbit skills get orbit" for the standalone binary, and "glab orbit skills get orbit <path>" for fetching referenced files — with concrete per-failure-mode actions (upgrade glab, upgrade the Orbit CLI to v0.131.0+, ask the user before installing). | 5 / 5 |
Workflow Clarity | The load-then-verify flow has an explicit validation checkpoint ("If the block above is not a skill (it should begin with `---`)"), and enumerated error-recovery branches for each failure mode (manual rerun, standalone binary, version upgrade, ask-before-install) form a genuine feedback loop; no destructive or batch operations exist to trigger the validation cap. | 5 / 5 |
Progressive Disclosure | This is a sub-50-line wrapper skill with no need for external references, and its sections are well organized; it even signals navigation into the loaded skill's bundle ("Links such as `references/recipes.md` ... Print them with `glab orbit skills get orbit <path>`"), which satisfies the simple-skill exception for a top score. | 5 / 5 |
Total | 19 / 20 Passed |