nextjs-app-router

nextjs-app-router is an agent for Claude Code from Matt-Dionis/claude-code-configs. It costs 55 tokens per session (823 once invoked), scanned A, original, MIT.

A specialist for routing and page structure in Next.js 15, a framework for building web applications with React. It works with URL-based folders, dynamic pages, shared layouts, loading states, and error pages.

In plain words
What is it for?
Use it when creating pages, layouts, dynamic routes, grouped routes, parallel views, or intercepted navigation in a Next.js app.
Why use it?
It helps keep navigation and route files consistent when an application has nested pages or changing URL parameters.

Agent for Claude Code

Written for Claude Code: installed under .claude/. Also seen: names the TodoWrite tool.

Good fit Use it when creating pages, layouts, dynamic routes, grouped routes, parallel views, or intercepted navigation in a Next.js app.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/matt-dionis/claude-code-configs/nextjs-app-router
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/Matt-Dionis/claude-code-configs

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for nextjs-app-router

README.md
[![agentmods](https://agentmods.dev/badge/agents/matt-dionis/claude-code-configs/nextjs-app-router.svg)](https://agentmods.dev/agents/matt-dionis/claude-code-configs/nextjs-app-router)
Your own site
<a href="https://agentmods.dev/agents/matt-dionis/claude-code-configs/nextjs-app-router"><img src="https://agentmods.dev/badge/agents/matt-dionis/claude-code-configs/nextjs-app-router.svg" alt="Measured on agentmods" height="20"></a>
Per session 55 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 823 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00055 $0.00823
Opus 5 $0.00028 $0.00411
Sonnet 5 $0.00011 $0.00165
Haiku 4.5 $0.00006 $0.00082

Measured 8d ago against content hash dd73b895abc6, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade A, and why

nextjs-app-router scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

configurations/frameworks/nextjs-15/.claude/agents/nextjs-app-router.md · 121 lines

How it starts

The opening of the file, as written. The whole thing — 121 lines — stays where its author put it; the contents beside it link to each section on GitHub.

You are a Next.js 15 App Router expert specializing in modern routing patterns and application architecture.

Core Expertise

  • File-based routing with app/ directory structure
  • Dynamic routes with [param] and [...slug] patterns
  • Route groups with (folder) for organization without affecting URLs
  • Parallel routes with @folder for simultaneous rendering
  • Intercepting routes with (.)folder patterns
  • Nested layouts and template components

When Invoked

  1. Analyze the current routing structure
  2. Identify the specific routing requirement
  3. Implement using Next.js 15 best practices
  4. Ensure proper TypeScript types for route params
  5. Set up appropriate loading and error states

File Conventions You Must Follow

  • page.tsx - Unique UI for a route
  • layout.tsx - Shared UI that wraps pages
  • template.tsx - Re-rendered layout on navigation
  • loading.tsx - Loading UI with React Suspense
  • error.tsx - Error boundary for route segment
  • not-found.tsx - 404 page for route segment
  • route.ts - API endpoint handler
  • default.tsx - Fallback for parallel routes

Implementation Patterns

Creating a New Page

// app/[category]/[product]/page.tsx
interface PageProps {
  params: Promise<{
    category: string;
    product: string;
  }>;
  searchParams: Promise<{ [key: string]: string | string[] | undefined }>;
}

export default async function Page({ params, searchParams }: PageProps) {
  const { category, product } = await params;
  // Page implementation
}

Layout with Children

// app/layout.tsx
export default function Layout({
  children,
}: {
  children: React.ReactNode;
}) {
  return (
    <html lang="en">
      <body>{children}</body>
    </html>
  );
}

Error Boundary

// app/error.tsx
'use client';

export default function Error({
  error,
  reset,
}: {
  error: Error & { digest?: string };
  reset: () => void;
}) {
  return (
    <div>
      <h2>Something went wrong!</h2>
      <button onClick={reset}>Try again</button>
    </div>
  );
}

Read the full file on GitHub · 121 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 121 lines · 55 tokens per session scan A dd73b895abc6

Subscribe to this mod's changes

nextjs-app-router is an agent published in the GitHub repository Matt-Dionis/claude-code-configs (624 stars, last pushed 1y ago), licensed MIT. It adds 55 tokens to every session and 823 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other agents, from other repositories

react18-class-surgeon

Class component migration specialist for React 16/17 → 18.3.1. Migrates all three unsafe lifecycle methods with correct semantic replacements (not just UNSAFE prefix). Migrates legacy context to createContext, string refs to React.createRef(), findDOMNode to direct refs, and ReactDOM.render to createRoot. Uses memory…

github/awesome-copilot · 81 tokens

react19-auditor

Deep-scan specialist that identifies every React 19 breaking change and deprecated pattern across the entire codebase. Produces a prioritized migration report at .github/react19-audit.md. Reads everything, touches nothing. Invoked as a subagent by react19-commander.

github/awesome-copilot · 61 tokens

genpage-edit-planner

Plans edits to an existing generative page. Reads the downloaded page artifacts (source, original prompt, config), analyzes the current implementation against the user's edit intent, presents an edit plan via plan mode, and writes genpage-edit-plan.md for the orchestrator to execute. Called by the genpage skill — not…

microsoft/power-platform-skills · 73 tokens

react-portfolio-engineer

React portfolio/gallery sites for creatives: React 18+, Next.js App Router, image optimization.

notque/vexjoy-agent · 25 tokens

docs-app-builder

Use this agent to build a documentation application as a React app — from a repo's README, docs folder, or code. Trigger on "build a docs site", "documentation app for this project", "turn these docs into a website", "docs portal with navigation", or requests to make existing docs browsable/interactive. Returns a…

aayushostwal/nexus · 97 tokens

nextjs-expert

Next.js framework strategist. Makes decisions about rendering strategies (SSR/SSG/ISR), App Router patterns, data fetching, and performance optimization. Use when designing Next.js applications, choosing rendering methods, or architecting full-stack React apps.

armanzeroeight/fastagent-plugins · 53 tokens