Content
86%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 exemplary router-style SKILL.md body: lean, condition-driven routing to a well-organized one-level-deep reference bundle, with an explicit completion checkpoint and safety rules around credentials. The main gaps are minor: a couple of routing entries lack an actionable target file, and intermediate validation/error-recovery steps are implicit rather than signposted.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~25-line body is lean: a one-line purpose statement, a compact routing table, and five terse rules. It explains nothing Claude already knows and every line directs action ('read `../.env` before using URL, path, browser profile, or proxy defaults'), matching the 'every token earns its place' anchor. | 5 / 5 |
Actionability | As an instruction-only router skill it gives concrete, specific guidance: exact file paths per condition ('read `references/browser-access-selection.md`', 'read `references/wsl-notes.md` only when running under WSL') and unambiguous directives ('Never handle the user's GitHub password, passkey, recovery code, or 2FA secret'). Not a 5 because a few entries stop short of full executability — the 'Headless-only automation' bullet names no file to act on, and 'Reuse a fixed browser profile path' leaves the actual path to be hunted down in references. | 4 / 5 |
Workflow Clarity | The sequence is clear: shared variables first ('read `../.env` before using...'), an explicit entry point ('Always start here: read `references/browser-access-selection.md`'), conditional routing per environment, and an explicit completion checkpoint ('Treat environment setup as complete only after the target LangBot services are reachable and the browser profile can access the WebUI'). It misses the 5 anchor because per-step intermediate validation and error-recovery loops (e.g., what to check when a service fails to start) are delegated to references rather than signposted here, and the proxy fallback ('when external login... time out') is the only failure-path routing. | 4 / 5 |
Progressive Disclosure | The body is a pure overview that splits all environment-specific detail into seven real, one-level-deep reference files, each routed with an explicit condition ('only when running under WSL', 'when external login, model provider tests, or package downloads time out'), and it even enforces the discipline in rules ('Keep environment-specific paths and commands in `references/`, not in this file'). All referenced paths verified to exist with no nested indirection. | 5 / 5 |
Total | 18 / 20 Passed |