Content
22%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 well-sectioned but nearly empty stub: the "Use when" list is genuinely useful, yet the instructions are generic filler, no actionable Next.js guidance exists, and its single reference points to a file that is missing from the bundle. It fails to deliver the patterns it promises, either inline or via a working reference.
Suggestions
Replace the generic Instruction bullets with 3-5 concrete Next.js App Router patterns (e.g. a server component with data fetching, a Server Action with revalidation, a parallel-routes layout sketch) so the body is actionable on its own.
Fix the broken reference: the bundle has no resources/ directory — either ship resources/implementation-playbook.md or point to a file that exists in references/.
Delete the vacuous "Do not use this skill when" bullets and the duplicated description line, and describe the playbook's contents (what sections it holds) so the reference is informative.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is short and sectioned, but a large share is vacuous boilerplate Claude already knows: "The task is unrelated to next.js app router patterns", "You need a different domain or tool outside this scope", "Apply relevant best practices and validate outcomes", plus a line duplicating the frontmatter description. Anchor 3 ('mostly efficient but includes some unnecessary explanation'); not 4 because the padding is more than minor, not 2 because the total footprint is small and no background concepts are explained. | 3 / 5 |
Actionability | No code, commands, patterns, or concrete steps appear anywhere in the body — the Instructions are platitudes ("Apply relevant best practices and validate outcomes", "Provide actionable steps and verification") and everything substantive is delegated to a reference file. This matches anchor 1 ('entirely vague or abstract; no concrete code or commands'); not 2 because anchor 2 requires high-level hints about actual task steps, and none are present. | 1 / 5 |
Workflow Clarity | There is no sequence of steps, no ordering, and no validation checkpoints — the "Instructions" bullets are universal truisms unrelated to any Next.js workflow. Anchor 1 ('steps missing or incoherent; no sequence'); not 2 because not even a rough sequence exists. | 1 / 5 |
Progressive Disclosure | Sections are well organized and the reference is clearly signaled with its purpose ("resources/implementation-playbook.md for detailed patterns and examples"), one level deep. However, the actual bundle contains no resources/, references/, scripts/, or assets/ directories — the referenced playbook file does not exist, so navigation is broken and the body is a stub pointing at nothing, resembling the bad "See advanced.md for more details" example. Anchor 3; not 4 because a good-structure score requires working references and appropriately placed content, not 2 because the reference is clearly signaled rather than buried and no content is misfiled inline. | 3 / 5 |
Total | 8 / 20 Passed |