Content
81%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 highly actionable, well-validated operational manual: every step is executable, gated by explicit checks, and paired with error-recovery guidance. The main weaknesses are conciseness (repeated refresh/pin semantics and run-on edge-case prose) and progressive disclosure (dangling reference targets in the provided bundle and heavy inlining that a split into reference files would relieve).
Suggestions
Consolidate the repeated '1.18.25' pins and refresh semantics into one stated place (e.g. a short 'Pins and refresh' note) instead of restating them in Install, Authenticate, and the native-test section.
Break the opening edge-case paragraphs into short bulleted notes so each install/auth caveat is scannable rather than buried in run-on prose.
Move the file copy manifest and env-variable reference into a linked reference file (and ship ARCHITECTURE.md/REMOVE.md alongside the skill) so SKILL.md reads as an overview with verifiable one-level-deep references.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Almost every line is system-specific operational fact with no padding or explanations of known concepts, but the opening paragraphs are dense run-on edge-case dumps, refresh/pin semantics are repeated across the Install and Authenticate sections, and the exact version '1.18.25' appears inline six times instead of being consolidated. Not 4 because tightening requires more than minor trims; not 2 because nothing is concept-explaining filler. | 3 / 5 |
Actionability | Fully executable throughout: copy-paste commands ('pnpm exec tsx setup/index.ts --step provider-auth opencode', 'ncl groups config update --id <group-id> --provider opencode'), a complete runnable compatibility-check one-liner, an exact file copy manifest, pinned dependency declarations, and a runnable native-test recipe with 'OPENCODE_TEST_BINARY'. Covers the common install/auth/model cases completely. | 5 / 5 |
Workflow Clarity | Clear Install → Authenticate → Recover login → Change model → Backend defaults sequence with explicit validation and feedback loops: the compatibility predicate 'guards every subsequent step', tests 'must pass before rebuilding the agent image', 'Send a message and verify a reply, then send a second message', and error recovery for vault/duplicate-name failures and expired logins ('--reauth', 'Retry the failed request'). | 5 / 5 |
Progressive Disclosure | Sections are well organized and the outbound links ([ARCHITECTURE.md], [REMOVE.md]) are one level deep and clearly signaled, but the provided bundle contains no such files (no references/, payload/, or docs directories), so the reference targets cannot be verified, and ~345 lines of operational detail (copy manifest, env-var reference, auth recovery) are fully inlined. Not 5 because content is not split into an overview plus detailed reference files; not 3 because structure and signaling are good. | 4 / 5 |
Total | 17 / 20 Passed |