Agent skill

Nextjs App Router

Ensure correct Next.js App Router architecture, rendering strategy, and data fetching.

AGPL-3.0Auto-check passed

Install Nextjs App Router

skills CLI

$ npx skills add Asymmetric-al/core --skill nextjs-app-router -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install Asymmetric-al/core nextjs-app-router --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/Asymmetric-al/core.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/nextjs-app-router .claude/skills/nextjs-app-router && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "nextjs-app-router" agent skill from https://github.com/Asymmetric-al/core/tree/develop/.agents/skills/nextjs-app-router into .claude/skills/nextjs-app-router/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nextjs-app-router", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/Asymmetric-al/core/tree/develop/.agents/skills/nextjs-app-router

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add Asymmetric-al/core --skill nextjs-app-router -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install Asymmetric-al/core nextjs-app-router --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Asymmetric-al/core.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/nextjs-app-router .agents/skills/nextjs-app-router && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "nextjs-app-router" agent skill from https://github.com/Asymmetric-al/core/tree/develop/.agents/skills/nextjs-app-router into .agents/skills/nextjs-app-router/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nextjs-app-router", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add Asymmetric-al/core --skill nextjs-app-router -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install Asymmetric-al/core nextjs-app-router --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Asymmetric-al/core.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/nextjs-app-router .cursor/skills/nextjs-app-router && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "nextjs-app-router" agent skill from https://github.com/Asymmetric-al/core/tree/develop/.agents/skills/nextjs-app-router into .cursor/skills/nextjs-app-router/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nextjs-app-router", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/Asymmetric-al/core.git --path .agents/skills/nextjs-app-router

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add Asymmetric-al/core --skill nextjs-app-router -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install Asymmetric-al/core nextjs-app-router --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Asymmetric-al/core.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/nextjs-app-router .gemini/skills/nextjs-app-router && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "nextjs-app-router" agent skill from https://github.com/Asymmetric-al/core/tree/develop/.agents/skills/nextjs-app-router into .gemini/skills/nextjs-app-router/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nextjs-app-router", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install Asymmetric-al/core nextjs-app-router

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add Asymmetric-al/core --skill nextjs-app-router -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/Asymmetric-al/core.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/nextjs-app-router .github/skills/nextjs-app-router && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "nextjs-app-router" agent skill from https://github.com/Asymmetric-al/core/tree/develop/.agents/skills/nextjs-app-router into .github/skills/nextjs-app-router/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nextjs-app-router", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add Asymmetric-al/core --skill nextjs-app-router -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install Asymmetric-al/core nextjs-app-router --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Asymmetric-al/core.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/nextjs-app-router .opencode/skills/nextjs-app-router && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "nextjs-app-router" agent skill from https://github.com/Asymmetric-al/core/tree/develop/.agents/skills/nextjs-app-router into .opencode/skills/nextjs-app-router/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "nextjs-app-router", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: nextjs-app-router
GitHub stars: 381
Token cost: ~787 tokens
SKILL.md length: 291 words
Files: 1
Skills in repo: 43
Repo updated: Oct 9, 2026
First seen: Oct 7, 2026
Licence: AGPL-3.0

At a glance

Ensure correct Next.js App Router architecture, rendering strategy, and data fetching.

Works in 6 steps: Decide server vs client boundaries first. → Choose the rendering strategy… → Fetch data in the closest Server… → …
Working under /app — routing
SKILL.md covers Rules, Workflow, Checklists and Minimal examples, plus 1 more section
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Nextjs App Router is an agent skill from Asymmetric-al/core. Ensure correct Next.js App Router architecture, rendering strategy, and data fetching. Use whenever working under /app — routing, layouts, server/client component boundaries, data fetching, Suspense, and Server Actions. Defaults to Server Components and adds 'use client' only for interactivity. Not for the Pages Router (/pages).

Its SKILL.md is about 790 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with Next.js. The repository describes itself as: A high-performance, enterprise-grade Next.js 16 application for mission-focused non-profit organizations. Built for high impact teams. The licence is AGPL-3.0.

When your agent uses it

Working under /app — routing
Server/client component boundaries

Example prompts

“use client”
“/nextjs-app-router”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

Decide server vs client boundaries first.
Choose the rendering strategy (static/cached/dynamic).
Fetch data in the closest Server Component.
Isolate interactivity into small Client Components.
Add Suspense boundaries for dynamic or slow UI.
Use Server Actions for mutations and add error boundaries.

What it can do on your machine

Read from SKILL.md and the folder at commit c30c8ff. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are typescript).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Nextjs App Router loads about 787 tokens when it runs. Until then it costs about 87 tokens; SKILL.md has 291 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~87
When it runs · the whole SKILL.md, loaded when a task matches: ~787

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Asymmetric-al/core at commit c30c8ff, republished under its AGPL-3.0 licence (© Asymmetric-al). 291 words, ~787 tokens.

Download SKILL.mdSave it as .claude/skills/nextjs-app-router/SKILL.md (or your agent's skills folder).

name: nextjs-app-router
description: Ensure correct Next.js App Router architecture, rendering strategy, and data fetching. Use whenever working under /app — routing, layouts, server/client component boundaries, data fetching, Suspense, and Server Actions. Defaults to Server Components and adds 'use client' only for interactivity. Not for the Pages Router (/pages).

Next.js App Router — Skill

Name: nextjs-app-router Purpose: Ensure correct App Router architecture, rendering strategy, and data fetching in Next.js. Use this skill whenever working under /app.

Applies when: Routing, layouts, server/client boundaries, data fetching, Suspense, Server Actions. Do not use when: Working in the Pages Router (/pages) or non-Next.js projects.

Rules

Server-first: Default to Server Components; add 'use client' only for interactivity or browser APIs.
Routing/layouts: Use layout.tsx for shared UI; keep layouts stable; use route groups (group) for organization.
Data fetching: Fetch in Server Components by default and colocate with usage.
Rendering strategy: Choose static, cached, or dynamic intentionally; avoid accidental dynamic rendering.
Client components: Keep them small, prop-driven, and avoid server data fetching inside them.
Suspense/streaming: Use <Suspense> for slow or user-specific UI.
Mutations: Prefer Server Actions and invalidate caches as needed.
Errors: Use error.tsx and not-found.tsx for route-level handling.

Workflow

Decide server vs client boundaries first.
Choose the rendering strategy (static/cached/dynamic).
Fetch data in the closest Server Component.
Isolate interactivity into small Client Components.
Add Suspense boundaries for dynamic or slow UI.
Use Server Actions for mutations and add error boundaries.

Checklists

Implementation checklist

Server Components used by default
Client Components are small and justified
Data fetching is colocated and not duplicated
Rendering strategy is explicit
Suspense isolates dynamic UI
Server Actions used for mutations

Review checklist

No accidental 'use client' on large trees
No server data fetching inside client-only components
Errors handled via error.tsx / not-found.tsx

Minimal examples

Server Component (default)

tsx

export default async function Page() {
  const data = await getData();
  return <View data={data} />;
}

Client Component (isolated)

tsx

"use client";

export function Button({ onClick }: { onClick: () => void }) {
  return <button onClick={onClick}>Click</button>;
}

Layout usage

tsx

export default function Layout({ children }: { children: React.ReactNode }) {
  return (
    <>
      <Header />
      {children}
    </>
  );
}

Common mistakes / pitfalls

Marking entire pages as 'use client'
Fetching server data in Client Components
Reading request data in shared/cached logic
Overusing route segment config instead of code-local controls
Mixing routing concerns with component UI logic

Files

Just SKILL.md in .agents/skills/nextjs-app-router of Asymmetric-al/core.

Open the folder on GitHubat commit c30c8ff

Compare with similar skills

Nextjs App Router next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Nextjs App Router compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Nextjs App Router this skillAsymmetric-al/core	381	—	~787	Automated safety check: Pass	AGPL-3.0	yesterday
Sandbox Benchvercel/next.js	143k	—	~4.1k	Automated safety check: Pass	MIT	today
Next Dev Loopvercel/next.js	143k	9 repos	~2.3k	Automated safety check: Pass	MIT	today
Vercel Optimize Auditvercel-labs/agent-skills	32k	8 repos	~4.3k	Automated safety check: Pass	None	1 mo ago
Supabase Development and Debuggingsupabase/agent-skills	2.7k	3 repos	~3.6k	Automated safety check: Pass	MIT	8 days ago
AI SDKvercel-labs/ai-facts	168	20 repos	~1.2k	Automated safety check: Pass	None	5 mo ago

Similar skills

Sandbox Bench
vercel/next.js
Official
Benchmark React or Next.js changes on Vercel Sandbox VMs with paired A/B statistics: react PR/commit vs base, or Next.js PR/commit vs base, measured end-to-end through the bench/render-pipeline app…
143k GitHub stars~4.1k tokensUpdated today
Data & AnalyticsAuto-check passed
Next Dev Loop
vercel/next.js
Official
Verify Next.js runtime behavior after editing app code. An agent skill from vercel/next.js.
143k GitHub starsUsed in 9 repos~2.3k tokens
Productivity & AutomationAuto-check passed
Vercel Optimize Audit
vercel-labs/agent-skills
Official
Runs a metrics-first audit of a deployed Vercel project, gating investigations on real signals to produce ranked, citation-backed cost and performance recommendations.
32k GitHub starsUsed in 8 repos~4.3k tokens
DevOps & CloudAuto-check passed
Supabase Development and Debugging
supabase/agent-skills
Official
General Supabase skill for database, auth, Edge Functions, Realtime and storage work, plus client libraries, migrations, security audits, debugging and reading logs.
2.7k GitHub starsUsed in 3 repos~3.6k tokens
Backend & APIsAuto-check passed
AI SDK
vercel-labs/ai-facts
Official
Answer questions about the AI SDK and help build AI-powered features.
168 GitHub starsUsed in 20 repos~1.2k tokens
AI & LLM EngineeringAuto-check passed
React View Transitions Guide
vercel-labs/next-beats
Official
Guides implementing animated page and state transitions in React with the native View Transition API, covering shared elements, list reorders and directional navigation.
168 GitHub starsUsed in 11 repos~3.1k tokens
Frontend & DesignAuto-check passed

Questions about Nextjs App Router

What does Nextjs App Router do?

Ensure correct Next.js App Router architecture, rendering strategy, and data fetching. Nextjs App Router is an agent skill from Asymmetric-al/core.js App Router architecture, rendering strategy, and data fetching.

When should I use Nextjs App Router?

Nextjs App Router fits situations like: working under /app — routing; server/client component boundaries.

How do I install Nextjs App Router in Claude Code?

Run `npx skills add Asymmetric-al/core --skill nextjs-app-router -a claude-code`. Or copy the skill folder (.agents/skills/nextjs-app-router in Asymmetric-al/core) into .claude/skills/nextjs-app-router in your project. Claude Code loads it when a task matches its description.

How do I install Nextjs App Router in Codex?

Run `npx skills add Asymmetric-al/core --skill nextjs-app-router -a codex`. Or copy the skill folder (.agents/skills/nextjs-app-router in Asymmetric-al/core) into .agents/skills/nextjs-app-router in your project. Codex loads it when a task matches its description.

Can I use Nextjs App Router in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Asymmetric-al/core --skill nextjs-app-router -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/nextjs-app-router, .gemini/skills/nextjs-app-router, .github/skills/nextjs-app-router and .opencode/skills/nextjs-app-router in your project.

What does Nextjs App Router need to run?

SKILL.md names no scripts, command-line tools or credentials: Nextjs App Router is instructions for the agent only.

Does Nextjs App Router access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Nextjs App Router safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Nextjs App Router use?

Nextjs App Router is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Nextjs App Router use?

About 787 tokens (SKILL.md is roughly 3.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Nextjs App Router?

Skills that share tags, products or a category with Nextjs App Router: Sandbox Bench (vercel/next.js, 143k stars), Next Dev Loop (vercel/next.js, 143k stars), Vercel Optimize Audit (vercel-labs/agent-skills, 32k stars) and Supabase Development and Debugging (supabase/agent-skills, 2.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Nextjs App Router?

Asymmetric-al (a GitHub organization) maintains it in Asymmetric-al/core, which has 381 GitHub stars. The repository holds 43 skills in this directory. The repository was last updated on October 9, 2026.

Source: Asymmetric-al/core on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Nextjs App Router

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Next.js App Router — Skill

Rules

Workflow

Checklists

Implementation checklist

Review checklist

Minimal examples

Server Component (default)

Client Component (isolated)

Layout usage

Common mistakes / pitfalls

Files

Compare with similar skills

Similar skills

More from Asymmetric-al/core

Related

Questions about Nextjs App Router