nextjs-app-router-audit
Deep audit toolkit for Next.js App Router to fix performance waterfalls, SEO errors, and client boundary leaks.
- Detect and fix ignored metadata in Client Components
- Identify and flatten nested fetch waterfalls to improve TTFB
- Transition legacy next/head and next/image components to App Router standards
Free
Included in download
- Downloadable skill package
- Works with Cursor, and Aider.
- 1 permission declared
Sample input
Audit our new dashboard route for performance issues and SEO best practices.
Sample output
I found 3 issues in /app/dashboard:
- ERROR:
page.tsxuses "use client" and exportsmetadata. Metadata is ignored here; I'll move it to a layout or wrap the client logic. - WARN: 2 sequential awaited fetches found (Waterfalls).
- INFO: Missing
loading.tsx, preventing streaming. Fixing now...
nextjs-app-router-audit
Deep audit toolkit for Next.js App Router to fix performance waterfalls, SEO errors, and client boundary leaks.
Free
Included in download
- Downloadable skill package
- Works with Cursor, and Aider.
- 1 permission declared
- Instant install
Sample input
Audit our new dashboard route for performance issues and SEO best practices.
Sample output
I found 3 issues in /app/dashboard:
- ERROR:
page.tsxuses "use client" and exportsmetadata. Metadata is ignored here; I'll move it to a layout or wrap the client logic. - WARN: 2 sequential awaited fetches found (Waterfalls).
- INFO: Missing
loading.tsx, preventing streaming. Fixing now...
About This Skill
Stop guessing why your Next.js app is slow or breaking SEO
Modern Next.js development requires a deep understanding of the App Router's server/client boundaries. This skill provides a specialized diagnostic toolkit designed to audit codebases for performance bottlenecks, SEO regressions, and architectural anti-patterns that standard linters miss.
What it does
The skill combines a zero-dependency static scanner with a sophisticated manual review methodology. It identifies critical issues like metadata being ignored in Client Components, sequential request waterfalls, and missing streaming fallbacks. Beyond simple detection, it provides ranked severity reports and concrete code fixes for every issue found.
- Detects SEO-killing errors like using
next/headin the App Router. - Identifies performance drains such as unoptimized fonts and
useEffectfetch waterfalls. - Analyzes Server Component boundaries to ensure minimal JS is sent to the browser.
- Audits caching strategies and Suspense placement for optimal Core Web Vitals.
Why use this over basic prompting?
Simply asking an AI to "fix my Next.js app" often results in generic advice. This skill uses a specialized scanning script to trace your actual file tree, finding specific line numbers where rules are violated. It understands the nuance between a necessary Client Component and an accidental one, helping you maintain a high-performance "server-first" architecture.
Free to use. Made by Datagrove Development Agency in AmsterdamUse Cases
- Detect and fix ignored metadata in Client Components
- Identify and flatten nested fetch waterfalls to improve TTFB
- Transition legacy next/head and next/image components to App Router standards
- Optimize the Server/Client boundary to reduce client-side bundle size
- Implement missing loading.tsx and Suspense boundaries for better streaming
Known Limitations
- Uses regex heuristics instead of full AST parsing.
- Requires manual verification of complex caching logic.
- Best for Next.js 13.4 and newer (App Router).
How to Install
mkdir -p ~/.claude/skills && curl -sL https://www.agensi.io/api/install/nextjs-app-router-audit -o /tmp/nextjs-app-router-audit.zip && unzip -o /tmp/nextjs-app-router-audit.zip -d ~/.claude/skills && rm /tmp/nextjs-app-router-audit.zipFree skills install directly. Paid skills require purchase - use the download button above after buying.
Reviews
Security Scanned
Passed automated security review
Permissions
Allowed Hosts
File Scopes
Compatible with SKILL.md-compatible agents including Claude Code, Cursor, and Aider.
Frequently Asked Questions
Learn More About AI Agent Skills
More Premium Skills
keyword-research
Transform URLs or product lists into SEO keyword research packs with Google Ads data and intent-based clustering.
local-seo-audit
Automated local SEO auditing and keyword generation for agencies and small businesses.
competitor-content-gap-analyzer
Automated competitor content gap analysis and strategy reporting for SEO agencies and marketing teams.
designing-hybrid-context-layers
Architects the right retrieval strategy for every query — teaching your agent when to use RAG, a knowledge graph, or a temporal index instead of defaulting to vector search for everything.