Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The curated workflow is highly actionable and well-sequenced with verification, but the file is bloated by an auto-generated, partly-broken CLI reference that mixes unrelated subcommands inline with no progressive disclosure into separate files. Splitting the reference out and de-duplicating entries would meaningfully improve token efficiency.
Suggestions
Move the auto-generated CLI command reference into a separate references/ file (e.g. CLI_REFERENCE.md) and keep SKILL.md focused on the detect/search/install workflow, fixing the broken 'config opencode' description and removing duplicated config get/config list entries.
Trim subcommands not relevant to skill collection (autostart, env, setup, update) from the skill body or relocate them so the skill stays on-purpose.
Add a brief navigational pointer at the top (e.g. 'For full CLI command reference, see CLI_REFERENCE.md') so progressive disclosure is explicit and one level deep.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The curated workflow section is lean and useful, but the generated CLI reference is padded with redundant/duplicated entries (config get and config list appear twice) and a broken 'config opencode' description, plus many subcommands unrelated to skill collection, so it could be tightened considerably. | 2 / 3 |
Actionability | Provides fully executable, copy-paste-ready curl commands with concrete example JSON responses, install target paths, verification ls commands, and a complete end-to-end quick-start bash script. | 3 / 3 |
Workflow Clarity | The curated section sequences the process clearly as Detect → Review → Install → Verify, with an explicit Step 4 verification checkpoint and re-detection feedback loop covering the batch install operation. | 3 / 3 |
Progressive Disclosure | Content is organized into sections but everything is inline in one ~420-line file with no bundle files; the long CLI command reference is content that could be split into a separate reference file rather than inline. | 2 / 3 |
Total | 10 / 12 Passed |