Content
75%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 well-structured progressive-disclosure index: lean, navigable, with verified one-level references. The main weakness is that the body delegates everything — no inline code or rules for the most common cases — plus one orphaned bundle file.
Suggestions
Inline a few copy-paste snippets for the highest-frequency patterns (e.g. 'use client' directive placement, awaiting params/searchParams in Next.js 15+) so common tasks don't require loading a reference file.
Link references/app-router-files.md from the body (e.g. from the File Conventions section) or fold its content into file-conventions.md so no bundle file is undiscoverable.
Add a brief 'which file do I need' decision hint or ordering (e.g. check file-conventions and rsc-boundaries first when reviewing existing code) to guide selection across the 18 topics.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean ~145-line index: each section is a one-line pointer plus 3-5 topic bullets ("See [rsc-boundaries.md](references/rsc-boundaries.md) for: Async client component detection..."). No concept explanations Claude already knows, no padding; the one-line intros ("Next.js 15+ async API changes.") earn their place as version context. It is not below 5 — nothing here can be cut without losing discovery value. | 5 / 5 |
Actionability | Pointers are concrete (exact file paths with topic bullets), but the body itself contains no executable guidance — no code, commands, or rules; the directive "Apply these rules when writing or reviewing Next.js code" defers all actual rules to the references. This fits the 3 anchor (some concrete guidance but incomplete / missing key details) rather than 4, since even the most common cases (e.g. 'use client' placement, async params) have no inline example; it is above 2 because the navigation it does give is specific and immediately followable. | 3 / 5 |
Workflow Clarity | For a reference-lookup skill the single action is unambiguous (match the concern, read the named file), and the 18 concern-labeled sections make selection easy. Not a 5: with 18 parallel topics there is no guidance on priority or which file to consult when multiple apply, and no verification step for applying rules during code review; not a 3 because the structure itself is coherent and complete with no gaps in the lookup flow. | 4 / 5 |
Progressive Disclosure | Textbook one-level-deep structure: every section links a real file in references/ (all 19 linked paths verified to exist, no nested .md chains), each clearly signaled with topic bullets. It falls short of 5 because the bundle contains references/app-router-files.md, which is never linked from the body — an orphaned file that hurts discoverability against the 'easy navigation' anchor. | 4 / 5 |
Total | 16 / 20 Passed |