Content
62%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 skill body is highly actionable with an excellently sequenced and validated workflow, and it points to real, well-organized reference files. Its main weaknesses are severe verbosity (a Quick Start that duplicates the full workflow, simulated output blocks, and appended changelog patches) and progressive-disclosure defects where inline content duplicates existing reference files and several referenced files do not exist in the bundle.
Suggestions
Cut the body to a lean Quick Start plus a compact workflow outline, moving the Security Essentials and Troubleshooting Quick Fixes sections into the existing references/security-guide.md and references/troubleshooting.md instead of duplicating them inline.
Remove or drastically shorten the simulated boxed outputs (credentials display, connection-ready, status) — a one-line description of what the script prints suffices.
Fix dangling references: add the missing templates/ directory with ttyd.service and .env.template, and either have a script generate the ~/.ttyd/CONNECTION-KEEPALIVE-GUIDE.md and PERSISTENT-SESSION-GUIDE.md files or replace those cat commands with links into the references/ bundle; fold the two post-footer patch sections into the main workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~950-line body is heavily padded: the Quick Start duplicates the entire Workflow section verbatim, three full simulated boxed outputs are reproduced, sections explain concepts Claude already knows ('Run any command you normally run in terminal', 'Copy/paste: Works via browser's copy/paste'), and changelog-style patches ('NEW:', 'Fix Applied') are appended after the closing footer. It borders on anchor 1 but the bulk is still operational rather than concept explanation. | 2 / 5 |
Actionability | Commands are concrete and copy-paste ready throughout (./install.sh --ngrok, TTYD_PORT=7682 ./ttyd-start.sh, lsof -i :7681, ngrok config add-authtoken, tmux new -As ttyd-mobile — the latter two flags verified present in scripts/ttyd-start.sh). Missing anchor 5 because templates/ttyd.service and templates/.env.template are referenced but no templates/ directory exists, and ~/.ttyd/CONNECTION-KEEPALIVE-GUIDE.md and PERSISTENT-SESSION-GUIDE.md are cited but nothing in the bundle generates them. | 4 / 5 |
Workflow Clarity | Steps 1-6 are clearly sequenced with numbered sub-steps, expected outputs, per-step troubleshooting, explicit verification commands (ttyd --version, ./ttyd-status.sh, ./health-check.sh), error-to-fix feedback loops, and a success checklist. The operations are not destructive/batch, so no validation cap applies. | 5 / 5 |
Progressive Disclosure | Five real, well-signaled one-level-deep reference files exist and are linked with descriptions. However, ~250+ lines of Security Essentials and Troubleshooting Quick Fixes inline content duplicate the existing dedicated reference files, references point to a nonexistent templates/ directory, and two patch sections appended after the closing footer break navigation. Not anchor 4 given the duplication and broken references; not anchor 2 since references are clearly signaled and only one level deep. | 3 / 5 |
Total | 14 / 20 Passed |