Content
60%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.
The body is highly actionable and well-sequenced with real validation checkpoints and a clean one-level reference structure, but it is significantly over-long: padded sections and duplicated Quick-Start/Workflow content push conciseness down. Tightening the body and offloading peripheral sections to references would lift the weakest dimension.
Suggestions
Trim or move peripheral sections (Tips & Tricks, Performance Expectations, ttyd vs code-server comparison, Success Checklist) into a reference file or remove them — they explain concepts Claude already knows and roughly double the body length.
Collapse the duplicated Quick Start and full Workflow into a single sequenced procedure so steps are not stated twice; keep concrete commands but drop the repeated full connection-info output blocks.
Promote validation to explicit validate→fix→retry loops (e.g. after install and after start) to push workflow clarity from 4 toward 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body runs ~1010 lines with several padded sections (Tips & Tricks, Performance Expectations, ttyd-vs-code-server comparison, emoji success checklist, repeated full connection-info blocks) that explain things Claude already knows or restate the Quick Start in the longer Workflow. It is noticeably verbose rather than lean, fitting the 'several unnecessary explanations or padded sections' anchor and not the level-3 'mostly efficient' one. | 2 / 5 |
Actionability | Concrete executable commands appear throughout — `./install.sh`, `./configure-auth.sh`, `--writable`, `--ping-interval 3`, `TTYD_PORT=7682 ./ttyd-start.sh` — and the referenced scripts all exist, giving mostly copy-paste-ready guidance with only minor gaps (script internals are described rather than shown). | 4 / 5 |
Workflow Clarity | A clearly sequenced six-step workflow (Setup → Auth → Start → Connect → Stop → Status) with explicit validation checkpoints (1.4 Verify Installation, 5.2 Verify Stopped, health-check.sh) and recovery loops for the risky public-exposure operation. It sits just below the level-5 anchor because a few checkpoints are implicit rather than framed as validate→fix→retry. | 4 / 5 |
Progressive Disclosure | SKILL.md is an overview pointing to five real one-level-deep reference guides (installation, security, tunneling, networking, troubleshooting), all clearly signaled in a Reference Guides section. It is not level 5 because some inline content (Tips & Tricks, Performance Expectations, the comparison) arguably belongs in separate files, leaving minor organization gaps. | 4 / 5 |
Total | 14 / 20 Passed |