Content
93%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.
Highly actionable content: exact CLI commands, URL grammar, a sequenced install flow with confirmation and failure handling, and concrete worked examples. The only weaknesses are slight Overview/Safety-Notes redundancy and an implicit (rather than explicit) verification step for the remove operation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence (no explanation of what git or a safety gate is), but there is minor redundancy: the Overview's 'The CLI handles fetching, the safety gate, confirmation, on-disk write, and cross-machine sync' restates what the 'What happens when the user runs add' steps 1–6 then detail. This fits the 4 anchor (efficient, minor over-explanation that could be trimmed) rather than 5 (every token earns its place) and is well above 3. | 4 / 5 |
Actionability | Commands are copy-paste ready ('openscience skill add <git-url>', 'openscience skill remove <namespace>/<name>'), accepted URL forms are enumerated exactly, and the Examples section gives three worked cases with the precise command and expected interaction (wait for spinner + confirm prompt, relay y/N). This matches the 5 anchor (fully executable, covers common cases), not 4, since no key detail is missing. | 5 / 5 |
Workflow Clarity | The add workflow is a clear numbered sequence (clone → enumerate → layers 1/2/4 → server classifier → confirm screen → write + sync) with an explicit user-confirmation checkpoint and an error path for 'classifier unreachable'. However, the destructive/batch 'remove' operation has no explicit verification step beyond 'Report the count of archived skills', leaving a minor validation gap. This fits the 4 anchor (clear sequence, most checkpoints, minor validation gaps) rather than 5, and the present confirm/report checkpoints keep it above 3. | 4 / 5 |
Progressive Disclosure | The skill is a single self-contained document with well-organized sections (Overview, When to Use, How to Use, Examples, Safety Notes, Reference) and no bundle files; nothing inlined clearly belongs in a separate file, and the Reference pointers are one level deep and clearly signaled. For a compact self-contained skill this matches the 5 anchor's intent (clear overview, easy navigation, appropriately placed content) rather than 4, which would require organization gaps or misplaced content. | 5 / 5 |
Total | 18 / 20 Passed |