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 lean troubleshooting skill: every section is a concrete, repo-specific trap with mostly executable commands, and bulk reference material is properly externalized to wiki files with a clear pointer. The only weaknesses are minor: an undefined `$SF` variable in the secret snippet and missing post-change verification for the production-mutating secret/deploy operations.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and trap-focused: each section states one gotcha in a sentence or two plus a command, assumes Claude's competence ("Move both into request-time code or lazy thunks"), and adds nothing Claude already knows. Every token earns its place; not 4 because there is no over-explanation to trim. | 5 / 5 |
Actionability | Mostly copy-paste-ready commands: `bunx wrangler tail <worker-name> --env production`, the grep/sed/printf secret pipe, `bunx wrangler deploy --env production`, and the concrete `[[env.production.routes]]` directive. Minor gaps keep it from 5 — the secret snippet uses an undefined `$SF` variable and section 4 gives direction ("Move both into request-time code") without an example. | 4 / 5 |
Workflow Clarity | Sections are numbered in a sensible order (tail the failing worker first, then secrets, then deploy) and section 4 includes an explicit verification checkpoint ("Verify with a real `wrangler deploy`; `--dry-run` does not catch it"). Not 5 because production-mutating operations in sections 2–3 (secret put, deploy) lack a post-change verification step; not 3 because a diagnostic-first sequence and one explicit checkpoint are present. | 4 / 5 |
Progressive Disclosure | Under 50 lines with clear numbered sections, no bundle files, and bulk material (tier map, secrets checklist, deploy steps) correctly pushed to clearly-signaled wiki files (`wiki/shared/production-deploy.md`, `wiki/shared/dev-environment.md`) in the opening line — matching the simple-skill exception for well-organized short skills. | 5 / 5 |
Total | 18 / 20 Passed |