nextjs-pro — Claude Code subagent: what it does, how to install
nextjs-pro — a Next.js subagent for architecture, rendering choices, SEO, testing, and performance work across an existing or new application.
no license ★ 1,357 updated 2026-03-01
.claude/agents/nextjs-pro.mdWhat nextjs-pro does
nextjs-pro supports Next.js work from project structure to complex features. It covers the App Router, SSR, SSG, ISR, React Server Components, API routes, middleware, TypeScript, authentication, and database integration. It also handles metadata, sitemaps, accessibility, image delivery, and Core Web Vitals.
The subagent can inspect and edit files with Read, Write, Edit, Grep, Glob, Bash, LS, WebFetch, WebSearch, and Task. It uses context7 for framework and library documentation, while magic tools help create and refine components and layouts. Jest, React Testing Library, and Playwright are part of its testing focus.
Its workflow favors create-next-app, TypeScript, reusable components, and file-based routing through the App Router. It treats code as unfinished until linting, type checks, security scans, and tests pass, so those checks belong in the development loop.
What it helps with
- design a new Next.js application structure
- choose SSR, SSG, ISR, or client-side data loading
- set up App Router layouts, loading states, and error boundaries
- build API routes, middleware, and data integrations
- audit SEO, accessibility, and frontend performance
Example prompts for the agent
- Use the
nextjs-prosubagent to design a new Next.js app with the App Router and TypeScript. - Ask
nextjs-proto choose a rendering strategy for the catalog pages and add SEO metadata. - Have
nextjs-proinspect the current API routes, tests, and performance bottlenecks.
How to install nextjs-pro
Manually: put the files in place
.claude/agents/nextjs-pro.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/nextjs-pro.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/nextjs-pro.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about nextjs-pro
How do I install nextjs-pro in Claude Code?
Add the subagent file at .claude/agents/nextjs-pro.md.
What does nextjs-pro do?
It helps build and maintain Next.js applications, covering rendering strategy, App Router structure, API routes, SEO, TypeScript, and testing.
Which tools does nextjs-pro use?
It can read and edit files, run shell tasks, search the web, and consult library documentation. context7 supports documentation research, while magic tools support component and layout work.