Content
79%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a high-quality, actionable performance skill with excellent code examples covering the full stack (React, Next.js, TanStack Query, Drizzle). The content respects Claude's intelligence and provides concrete, executable patterns. Main weaknesses are the lack of explicit measure-fix-verify workflows and the monolithic structure that could benefit from splitting advanced topics into separate files.
Suggestions
Add explicit verification steps after each optimisation technique (e.g., 'After adding virtualisation, re-run React DevTools Profiler to confirm render count dropped')
Split advanced sections (TanStack Query Performance, Drizzle Query Performance, Large List Rendering) into separate reference files linked from a shorter overview
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient, assuming Claude's competence with React/Next.js concepts. Every section provides actionable code without explaining what React, memoisation, or databases are. The golden rule about measuring before optimising is valuable context, not padding. | 3 / 3 |
Actionability | Every technique includes complete, executable code examples with proper TypeScript typing. The virtualisation example, Drizzle queries, TanStack Query patterns, and dynamic imports are all copy-paste ready with real-world patterns. | 3 / 3 |
Workflow Clarity | While individual techniques are clear, the skill lacks explicit validation checkpoints. For performance optimisation, there should be clearer feedback loops like 'profile → identify bottleneck → apply fix → re-profile to verify improvement'. The golden rule mentions measuring but doesn't integrate verification into the workflow. | 2 / 3 |
Progressive Disclosure | The content is well-structured with clear sections and headers, but at ~300 lines it's quite long for a single file. Advanced topics like optimistic updates, prepared statements, and virtualisation could be split into separate reference files with links from a more concise overview. | 2 / 3 |
Total | 10 / 12 Passed |