Content
71%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.
A well-structured, actionable skill body with a clean step sequence and exemplary use of a single one-level-deep reference file. Its main weaknesses are redundancy — duplicated error/setup tables and thrice-repeated `doctor` instructions — and a non-executable status-check block in Step 1 that slightly undermines both conciseness and the validation entry point.
Suggestions
Merge the "Common setup issues" table and the "Error Reference" table into one diagnostics section (they share ~60% of their rows: Extension not connected, No session, AuthRequiredError) and drop the separate Step 5 Diagnostics section, which only repeats `opencli doctor`.
Replace or remove the non-executable `!`(command -v opencli ...) 2>/dev/null || ...` status block in Step 1 — either present it as a plain instruction ("run `command -v opencli && opencli doctor` to check readiness") or as an actual runnable snippet.
Resolve the `{version}` placeholder in the extension download step (e.g., "download the latest opencli-extension-*.zip from Releases") so the setup path is copy-paste ready.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient tables and command blocks, but redundancy goes beyond minor: the "Common setup issues" table and the "Error Reference" table repeat the same rows (Extension not connected, No session, AuthRequiredError), and `opencli doctor` is explained three separate times (Step 1, Step 5, and the error tables). The mangled `!`(command -v opencli...)` status block adds noise without executable value. Not 4: this is more than trimmable instances — whole duplicated sections could be consolidated. | 3 / 5 |
Actionability | Concrete, mostly copy-paste-ready commands throughout: `npm install -g @jackwener/opencli`, `opencli linkedin timeline --limit 20 -f json`, and search examples with real flag combinations, plus exact output columns. Not 5: the Step 1 "Current environment status" block uses broken `!`(...)` pseudo-syntax that is not executable, and the extension download link carries an unresolved `{version}` placeholder. Not 3: everything else is real, runnable CLI syntax with specific examples covering the common cases. | 4 / 5 |
Workflow Clarity | Clear five-step sequence (setup check → identify need → execute → present → diagnostics) with `opencli doctor` as an explicit validation checkpoint and an error cause/fix table forming a feedback loop. Not 5: the entry-point validation (Step 1) relies on the broken status-check block, and diagnostics are spread across Step 1, Step 5, and the error table rather than one coherent checkpoint. Not 3: sequence and error-recovery paths are present and explicit. | 4 / 5 |
Progressive Disclosure | The body is a well-organized overview pointing to a single real, one-level-deep reference (`references/commands.md` — verified present), clearly labeled with its contents ("all flags, research workflows, and usage examples") and an explicit when-to-read instruction. Not 4: the split is appropriate — overview and common cases inline, exhaustive flag detail in the reference — with no buried or nested references. | 5 / 5 |
Total | 16 / 20 Passed |