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.
A tight, high-signal debugging skill: it captures non-obvious env flags, file paths, and a webpack stats technique that Claude could not reconstruct on its own, with no padding. The main improvement opportunity is making the route-trace/chunk inspection steps as executable as the rest (e.g., an example grep/jq over nft.json or a skeleton test-start-webpack assertion).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and efficient throughout: every section delivers non-obvious information only (env var values and their effects, the exact source file 'packages/next/src/server/patch-error-inspect.ts', a minimal next.config.js snippet, a specific stats.toJson call). Nothing explains concepts Claude already knows; the one explanatory sentence about ignore-listed frames describes non-obvious framework behavior that earns its place. Not verbose in any section, so above the anchor-4 'minor trimming' case. | 5 / 5 |
Actionability | Mostly executable: exact flags ('IS_WEBPACK_TEST=1', 'NEXT_SKIP_ISOLATE=1', '__NEXT_SHOW_IGNORE_LISTED=true'), a copy-paste next.config.js block, concrete artifact paths ('.next/server/.../page.js.nft.json', 'next/dist/server/stream-utils/node-stream-helpers.js'), and a precise stats.toJson invocation. Not a 5 because steps 1-2 of the guardrail ('inspect route trace artifacts', 'inspect traced server chunks for forbidden internals') and the assertion in step 3 are described but give no example command or test snippet to copy. | 4 / 5 |
Workflow Clarity | The guardrail workflow is a clear numbered 1-2-3 sequence ending in a validation step ('fails on forbidden internals'), and the repro section includes an explicit re-validation check ('always rerun without NEXT_SKIP_ISOLATE=1'). Not a 5 because the skill is a set of parallel debugging techniques rather than one end-to-end sequence, and the webpack stats diffing section gives the what but no explicit ordered steps or diff-interpretation checkpoint. | 4 / 5 |
Progressive Disclosure | No bundle files exist (no references/, scripts/, or assets/), and the body is under 50 lines with clean, well-labeled sections each covering one technique — the simple-skill case where well-organized sections alone warrant a 5. The 'Related Skills' section is a single-level, clearly signaled pointer list ($flags, $dce-edge, $react-vendoring) with no nested references, so navigation is trivial and nothing that belongs in a separate file is inlined. | 5 / 5 |
Total | 18 / 20 Passed |