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.
The body is a dense, highly actionable operations manual: every workflow ships with exact commands, real endpoints, error-recovery paths, and explicit user-communication rules. Its main weakness is sheer length — long prose sections (stale-base protection, folders, vanity URLs) inflate the always-loaded SKILL.md instead of living in one-level-deep references like the external docs it already points to.
Suggestions
Trim the 'Stale-base protection' paragraph to the conflict rule and the two recovery options, moving the drift-detection endpoint walkthrough into a reference doc or the existing https://here.now/docs anchor.
Compress the 'Current docs' topic list (~15 bullets) to the handful that change most often, since the docs page itself enumerates all endpoints.
Move the folders section's raw-API details (endpoint-by-endpoint listing, limits like '50 folders per account, names up to 60 characters') to a bundled reference file or the referenced docs page, keeping only the --folder usage and the 'never invent folders' rule inline.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is ~320 lines and, while nearly all of it is non-obvious product detail (no padding with concepts Claude already knows), sections like the stale-base protection paragraph ('The live Site may have changed since your local files were published — the owner can edit it...') and the folders/vanity-URL/client-attribution details run long and could be tightened or split out. It fits 'mostly efficient but includes some unnecessary explanation or could be tightened' (level 3) rather than level 4's 'minor instances', because the length itself is a recurring cost across several sections. | 3 / 5 |
Actionability | Guidance is fully executable throughout: copy-paste commands ('./scripts/publish.sh {file-or-dir}', 'curl -sS https://here.now/api/auth/agent/request-code -H "content-type: application/json" -d '{"email": "user@example.com"}'), the complete three-step raw API flow ('POST /api/v1/publish with a files array... PUT each file's bytes... POST the returned finalizeUrl'), a concrete state-file JSON example, and a full flags table. This matches the level-5 anchor 'copy-paste ready code or commands; specific examples cover the common cases'. | 5 / 5 |
Workflow Clarity | Multi-step processes are clearly sequenced with validation checkpoints and feedback loops: the publish flow ('A site is not live until finalize succeeds', finalize reports missing files), the five-step API-key acquisition, and explicit conflict recovery ('if the live Site moved past it, the update is rejected with code: "version_conflict"... offer to (a) read the live files... or (b) re-run with --overwrite'), plus the explicit-yes checkpoint before irreversible domain purchases. This matches the level-5 anchor ('explicit validation steps; feedback loops for error recovery') rather than level 4's 'minor validation gaps'. | 5 / 5 |
Progressive Disclosure | The bundle is SKILL.md plus two verified scripts (./scripts/publish.sh, ./scripts/drive.sh), and the body keeps bulk detail in clearly signaled, one-level-deep external references ('→ **https://here.now/docs**', 'machine-readable schemas: https://here.now/openapi.json') with anchored sections. However, sizable inline content such as the versioning/stale-base prose and folder-management details is kept in SKILL.md rather than split into reference files, fitting 'good structure; most content is appropriately placed; minor organization gaps' (level 4) rather than level 5's fully split overview. | 4 / 5 |
Total | 17 / 20 Passed |