Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable with executable commands, clear tables, and a well-sequenced procedure including validation. Its main weaknesses are minor internal repetition and a single-file structure that inlines reference material rather than splitting it into bundle files.
Suggestions
Consolidate the repeated `/exit` warnings and inline flag examples with the Common Flags table to remove redundancy.
Move the TUI Keybindings and Common Flags tables into a references/ file (e.g. REFERENCE.md) and link from the body to improve progressive disclosure.
Cross-reference the Procedure steps to the detailed sections so the workflow path through the document is explicit.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly lean and command-driven, but several items repeat unnecessarily — the `/exit` warning appears three times (lines 98, 192, 219) and the Common Flags table duplicates flags already shown inline — so it could be tightened. | 2 / 3 |
Actionability | It provides numerous copy-paste-ready, executable commands (e.g. `opencode run '...'`, `terminal(command=...)`, `process(action="submit", ...)`) plus concrete flag and keybinding tables, fully matching the executable score-3 anchor. | 3 / 3 |
Workflow Clarity | A numbered Procedure sequences readiness checks, one-shot vs. interactive paths, monitoring, and clean exit, with an explicit Verification smoke test and success criteria, and a Pitfalls feedback loop (inspect logs before killing) — clear sequence with validation. | 3 / 3 |
Progressive Disclosure | The skill is a single ~200-line file with no bundle files and no external references; the Common Flags and TUI Keybindings tables are inline reference material that could be split out, fitting the 'content that should be separate is inline' score-2 anchor rather than the under-50-line simple-skill allowance. | 2 / 3 |
Total | 10 / 12 Passed |