aiskillstore/marketplace / skills/89jobrien/nextjs-architecture
nextjs-architecture
VerifiedNext.js architecture specialist. Use when designing Next.js applications, migrating to App Router, implementing Server Components, or optimizing Next.js performance. Covers App Router, Server Components, and best practices.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.4 KB |
| skill-report.json | config | 17.6 KB |
skill-report.json
View on GitHub{
"schema_version": "2.0",
"meta": {
"generated_at": "2026-07-05T13:14:34.834Z",
"slug": "89jobrien-nextjs-architecture",
"source_url": "https://github.com/89jobrien/steve/tree/main/steve/skills/nextjs-architecture",
"source_ref": "main",
"model": "codex",
"analysis_version": "3.0.0",
"source_type": "community",
"content_hash": "e499fdb2be37efc07de50cb09c9ae3feef96f01684c7bbdedb092ec798f8af14",
"tree_hash": "89cf321d0ddf75b0a9e9ef3249ab10350004490e1eff98bac9f2bf8427acbf9b",
"provenance": {
"model_effective": "codex",
"fallback_chain": [
{
"agent": "codex",
"outcome": "success"
}
],
"analysis_version": "3.0.0"
}
},
"skill": {
"name": "nextjs-architecture",
"description": "Guides Next.js architecture decisions for App Router, Server Components, migration planning, and performance optimization.",
"summary": "Plan Next.js App Router structures, component boundaries, migrations, and production performance work.",
"icon": "📦",
"version": "1.0.2",
"author": "Joseph OBrien",
"license": "MIT",
"category": "coding",
"tags": [
"nextjs",
"app-router",
"server-components",
"architecture",
"performance"
],
"supported_tools": [
"claude",
"codex",
"claude-code"
],
"risk_factors": [
"external_commands"
]
},
"security_audit": {
"risk_level": "safe",
"is_blocked": false,
"safe_to_publish": true,
"analysis_status": "ok",
"summary": "Static analysis flagged Markdown code fences as Ruby or shell backtick execution. Review of SKILL.md shows these lines are examples, directory trees, and TypeScript samples, not commands executed by the skill. No prompt injection or intent-level abuse was found.",
"remediation": [],
"risk_factor_evidence": [
{
"factor": "external_commands",
"evidence": [
{
"file": "SKILL.md",
"line_start": 40,
"line_end": 42
},
{
"file": "SKILL.md",
"line_start": 42,
"line_end": 44
},
{
"file": "SKILL.md",
"line_start": 44,
"line_end": 46
},
{
"file": "SKILL.md",
"line_start": 46,
"line_end": 50
},
{
"file": "SKILL.md",
"line_start": 50,
"line_end": 52
},
{
"file": "SKILL.md",
"line_start": 52,
"line_end": 58
},
{
"file": "SKILL.md",
"line_start": 58,
"line_end": 70
},
{
"file": "SKILL.md",
"line_start": 70,
"line_end": 99
},
{
"file": "SKILL.md",
"line_start": 99,
"line_end": 105
},
{
"file": "SKILL.md",
"line_start": 105,
"line_end": 119
},
{
"file": "SKILL.md",
"line_start": 119,
"line_end": 123
},
{
"file": "SKILL.md",
"line_start": 123,
"line_end": 134
},
{
"file": "SKILL.md",
"line_start": 134,
"line_end": 136
}
]
}
],
"static_findings": [
{
"id": "external_commands:SKILL.md:40:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 40,
"line_end": 42,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:42:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 42,
"line_end": 44,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:44:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 44,
"line_end": 46,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:46:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 46,
"line_end": 50,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:50:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 50,
"line_end": 52,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:52:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 52,
"line_end": 58,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:58:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 58,
"line_end": 70,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:70:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 70,
"line_end": 99,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:99:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 99,
"line_end": 105,
"snippet": "```markdown"
},
{
"id": "external_commands:SKILL.md:105:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 105,
"line_end": 119,
"snippet": "```typescript"
},
{
"id": "external_commands:SKILL.md:119:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 119,
"line_end": 123,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:123:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 123,
"line_end": 134,
"snippet": "```typescript"
},
{
"id": "external_commands:SKILL.md:134:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 134,
"line_end": 136,
"snippet": "```"
}
],
"finding_verdicts": [
{
"id": "external_commands:SKILL.md:40:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "Lines 40-42 contain a Markdown prompt example inside a fenced block. The text is not Ruby, shell code, or an executable command."
},
{
"id": "external_commands:SKILL.md:42:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "Lines 42-44 close and reopen Markdown fences around usage examples. No command invocation or dynamic execution pattern is present."
},
{
"id": "external_commands:SKILL.md:44:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "Lines 44-46 contain a plain language migration prompt in a Markdown fence. It is documentation text, not executable shell syntax."
},
{
"id": "external_commands:SKILL.md:46:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "Lines 46-50 transition between Markdown examples and a heading. The backticks are fence delimiters only."
},
{
"id": "external_commands:SKILL.md:50:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "Lines 50-52 show a prompt to implement Server Components. This is documentation content and contains no shell execution."
},
{
"id": "external_commands:SKILL.md:52:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "Lines 52-58 close a prompt example and introduce an architecture section. The flagged backticks are Markdown formatting."
},
{
"id": "external_commands:SKILL.md:58:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "Lines 58-70 contain an example App Router directory tree. It is a static documentation sample, not a command."
},
{
"id": "external_commands:SKILL.md:70:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "Lines 70-99 close the directory-tree fence and describe Next.js patterns. No external process execution appears in this range."
},
{
"id": "external_commands:SKILL.md:99:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "Line 99 starts a Markdown output example with a language tag. It is a fenced documentation block, not Ruby backtick execution."
},
{
"id": "external_commands:SKILL.md:105:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "Lines 105-119 contain TypeScript migration sample code. The backticks mark the code fence and do not execute commands."
},
{
"id": "external_commands:SKILL.md:119:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "Lines 119-123 close one TypeScript example and introduce another. The flagged marker is Markdown formatting only."
},
{
"id": "external_commands:SKILL.md:123:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "Lines 123-134 contain a TypeScript page-conversion example. It is illustrative source text with no shell or Ruby execution."
},
{
"id": "external_commands:SKILL.md:134:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.98,
"reason": "Lines 134-136 close nested Markdown examples. The static signal is caused by fence delimiters, not an execution primitive."
}
],
"semantic_findings": [],
"critical_findings": [],
"high_findings": [],
"medium_findings": [],
"low_findings": [],
"dangerous_patterns": [],
"files_scanned": 1,
"total_lines": 155,
"audit_model": "codex",
"audited_at": "2026-07-05T13:14:34.834Z",
"agent_auto_install_policy": "allowed",
"manual_install_policy": "allowed"
},
"content": {
"user_title": "Plan Next.js App Router Architecture",
"value_statement": "Next.js teams can struggle to choose routes, components, data loading, and migration steps. This skill gives structured architecture guidance for App Router, Server Components, and performance.",
"seo_keywords": [
"Claude",
"Codex",
"Claude Code",
"Next.js architecture",
"App Router",
"Server Components",
"Pages Router migration",
"Next.js performance",
"React full stack",
"Next.js best practices"
],
"actual_capabilities": [
"Designs App Router folder structures for authenticated, dashboard, and API areas.",
"Guides migration from Pages Router to App Router layouts and pages.",
"Recommends Server Component and Client Component boundaries.",
"Suggests performance strategies such as static generation, ISR, streaming, images, and code splitting.",
"Applies production-focused Next.js architecture best practices."
],
"limitations": [
"Does not inspect a live repository unless the host agent provides project files.",
"Does not execute migrations, install packages, or run build commands by itself.",
"Guidance may need adjustment for current Next.js releases and project constraints.",
"Does not replace security, accessibility, or production performance testing."
],
"use_cases": [
{
"title": "Design a New Product Architecture",
"description": "Create a Next.js App Router structure with route groups, layouts, API routes, and data loading choices.",
"target_user": "Frontend architect"
},
{
"title": "Plan a Router Migration",
"description": "Convert Pages Router concepts into App Router layouts, pages, and server-first data patterns.",
"target_user": "Full-stack developer"
},
{
"title": "Review Production Readiness",
"description": "Evaluate component boundaries, rendering modes, streaming, image handling, and code splitting before release.",
"target_user": "Engineering lead"
}
],
"prompt_templates": [
{
"title": "Plan a New App Router Project",
"prompt": "Use the nextjs-architecture skill to design an App Router structure for a [type] app with [features]. Include route groups, layouts, and data loading guidance.",
"scenario": "Beginner planning for a new Next.js application"
},
{
"title": "Choose Component Boundaries",
"prompt": "Review this feature plan and recommend Server Components, Client Components, Suspense boundaries, and data fetching patterns.",
"scenario": "Intermediate feature design"
},
{
"title": "Migrate Pages Router",
"prompt": "Analyze this Pages Router structure and create a phased migration plan to App Router. Include layout conversion, route mapping, and risk checks.",
"scenario": "Advanced migration planning"
},
{
"title": "Optimize Production Architecture",
"prompt": "Audit this Next.js architecture for performance and scalability. Recommend static generation, ISR, streaming, caching, image strategy, and code splitting improvements.",
"scenario": "Advanced production optimization"
}
],
"output_examples": [
{
"input": "Migrate a user dashboard from Pages Router to App Router.",
"output": "A phased migration plan with route mapping, layout changes, Server Component guidance, validation steps, and release risks."
},
{
"input": "Design a new application with authentication, dashboards, and API routes.",
"output": "An App Router folder strategy with route groups, shared layouts, API boundaries, and recommended rendering choices."
},
{
"input": "Review a slow Next.js feature before production launch.",
"output": "A performance review covering static generation, ISR, streaming, image optimization, code splitting, and component boundaries."
}
],
"best_practices": [
"Provide current route structure, key pages, data sources, and auth requirements.",
"Ask for migration risks, fallback plans, and validation checks when changing routers.",
"Validate recommendations against the exact Next.js version and deployment platform."
],
"anti_patterns": [
"Asking for a full architecture without sharing routes, data needs, or constraints.",
"Applying Client Components broadly when Server Components satisfy the feature.",
"Treating generated migration steps as complete without testing build, routing, and performance."
],
"faq": [
{
"question": "Does this skill write Next.js code?",
"answer": "It can suggest code patterns when the host agent asks, but its main purpose is architecture guidance."
},
{
"question": "Can it migrate an entire repository automatically?",
"answer": "No. It can create a migration plan and guide changes when repository files are provided."
},
{
"question": "Does it support the App Router?",
"answer": "Yes. The skill focuses on App Router structure, layouts, route groups, and Server Components."
},
{
"question": "Can it help with Server Components?",
"answer": "Yes. It recommends when to use Server Components, Client Components, Suspense, and server-first data access."
},
{
"question": "Does it cover performance optimization?",
"answer": "Yes. It covers static generation, ISR, streaming, image optimization, and code splitting."
},
{
"question": "Which AI tools can use this skill?",
"answer": "The report lists support for Claude, Codex, and Claude Code."
}
]
},
"file_structure": [
{
"name": "SKILL.md",
"type": "file",
"path": "SKILL.md",
"lines": 155
}
]
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |