debug-perf
Installation
SKILL.md
Diagnose slow or overheating Next.js apps. Works in dev and production.
Steps
1. Check for compile loops
ls -lh /tmp/*.log 2>/dev/null
# If any log is >100MB, a hot reload loop is running
Look for repeated module resolution errors in the dev server output. Common culprit: geist/font/* imports breaking with Turbopack. Fix by switching to next/font/google:
// layout.tsx — replace geist package imports
import { Geist, Geist_Mono } from "next/font/google";
const GeistSans = Geist({ subsets: ["latin"], variable: "--font-geist-sans" });
const GeistMono = Geist_Mono({ subsets: ["latin"], variable: "--font-geist-mono" });