Content
96%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.
An exceptionally operational, lean skill body with executable commands, a clear sequenced workflow, and real validation/feedback loops around destructive operations. The one gap is that two referenced bundle files are cited but missing from disk.
Suggestions
Create the referenced references/access-troubleshooting.md and references/sync.md (or remove the links) so the progressive-disclosure pointers resolve to real files.
If access-troubleshooting and sync detail is small, consider inlining the essentials and dropping the external references to make the skill self-contained.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with domain-specific, non-obvious operational facts Claude would not know ('~/.hogli/bin is not on PATH', 'A non-login shell doesn't reliably load the shell profile', region/label naming, --start-app persistence) and never re-explains what a devbox, Coder, or PostHog is — every token earns its place. | 5 / 5 |
Actionability | Provides copy-paste-ready, executable commands throughout — 'hogli devbox:start --start-app', 'hogli devbox:exec -- bash -lc "curl ..."', the 'coder list --output json | jq' health check — with exact flags, the URL template, and concrete coverage of new-vs-running and shell-vs-editor-vs-app cases. | 5 / 5 |
Workflow Clarity | Opens with a tracked numbered checklist, then sequences each step (Check access → Set up → Start → Connect → Stop) with explicit validation: doctor's read-only reachability check first, a bounded poll loop keyed on 200/302 vs 000/502, and destructive-op guards (confirmation before -y, 'don't keep anything irreplaceable only on a box', stop the source stack before clone). | 5 / 5 |
Progressive Disclosure | Good section structure with well-signaled one-level-deep references to references/access-troubleshooting.md and references/sync.md inline at the relevant steps, but the referenced files do not exist in the bundle, so the disclosure does not fully resolve. | 4 / 5 |
Total | 19 / 20 Passed |