hoangnguyen0403/nextjs-upgrade
skills/nextjs/nextjs-upgrade/SKILL.md
Next.js version migrations using official guides and codemods. Use when migrating a Next.js project to a new major version using codemods.
$ install --global
skillsauthnpx skillsauth add hoangnguyen0403/agent-skills-standard nextjs-upgradeInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 20, 2026, 3:06 AM246.1s3 files scanned
SKILL.md
- name:
- nextjs-upgrade
- description:
- Next.js version migrations using official guides and codemods. Use when migrating a Next.js project to a new major version using codemods.
Next.js Upgrade Protocol
Automated and manual migration steps for Next.js version upgrades (e.g., v14 to v15).
Priority: P1 (OPERATIONAL)
Workflow: Upgrade Next.js to New Major Version
- Check current versions of
next,react,react-dominpackage.json - Plan incremental path (e.g., v13 -> v14 -> v15; never skip majors)
- Run codemods:
npx @next/codemod@latest <transform> <path> - Update dependencies: See implementation examples
- Verify async APIs: ensure
cookies(),headers(),paramsawaited (v15+) - Audit
fetchcaching: v15 defaults tono-store; addforce-cachewhere needed - Run
next buildand fix hydration or Turbopack errors - Report codemod failures or manual fixes to team
Implementation Guidelines
- Upgrade Detection: Always check
package.jsonfor versions ofnext,react, andreact-dom. - Planning: For major version jumps (v13 to v15), perform incremental upgrade (v13 -> v14, then v14 -> v15). Follow official Next.js Migration Guides.
- Automated Codemods: Use
npx @next/codemod@latest <transform> <path>to automate syntax migration. - Breaking Changes (v15): Respond to
next-async-request-apitransform by ensuringparams,searchParams,cookies(), andheaders()awaited. - React Parity: Upgrade
reactandreact-domto match Next.js peer dependencies (e.g., React 19 for Next.js 15). - Validation: Run
next devandnext buildafter each incremental step. Check console errors for hydration warnings.
Anti-Patterns
- No major version skipping: Upgrade one major version at time (13 -> 14, then 14 -> 15).
- No manual breaking-change fixes: Always run
npx @next/codemod@latesttransforms first. - No assumed caching behavior post-upgrade: v15 defaults to
no-store; audit allfetchcalls. - No async page functions in Pages Router:
export default async function Page()fatal.
Related Skills
hoangnguyen0403/common-operator-profile
testing
VerifiedTrustedCommunity
Infer the requesting operator's technical fluency from message content (never ask directly) and adapt register — business, hybrid, or technical — across SDLC workflow output. Use when starting sdlc, brainstorm-feature, plan-feature, verify-work, publish-notes, or session-report, or whenever a request's phrasing signals a non-technical or cross-stack operator.
524SKILL.mdUpdated Jul 12, 2026
hoangnguyen0403/database-transactions
documentation
VerifiedTrustedCommunity
Define transaction boundaries, locking, and consistency guarantees for multi-step writes. Use when designing atomic operations, retries, idempotency, or concurrent write behavior.
524SKILL.mdUpdated Jun 19, 2026
hoangnguyen0403/database-schema-design
development
VerifiedTrustedCommunity
Design relational or document schemas from access patterns, cardinality, and lifecycle. Use when modeling entities, choosing embed vs normalize, or shaping schema boundaries before implementation.
524SKILL.mdUpdated Jun 19, 2026
hoangnguyen0403/database-query-performance
data-ai
VerifiedTrustedCommunity
Diagnose database latency with explain plans, index ownership, and query-shape review. Use when a query is slow, an index is missing, or scans and N+1 patterns appear.
524SKILL.mdUpdated Jun 19, 2026