{"id":24868,"plugin_id":"plugin_connector_690a90ec05c881918afb6a55dc9bbaa1","kind":"skill","collection_source":null,"comparison_source":null,"observed_at":"2026-09-30T23:18:44.376Z","digest":"970ddefc515eb08f0b1facfb5a7a1ae413ae7d34051746edf2d3b5e96a872955","against":5328,"payload":{"name":"next-upgrade","description":"Upgrade Next.js to the latest version following official migration guides and codemods. Use when upgrading Next.js versions, running codemods, or migrating between major releases.","included_files":[{"relative_path":"agents/openai.yaml","size_in_bytes":120}],"skill_md_contents":"---\nname: next-upgrade\ndescription: Upgrade Next.js to the latest version following official migration guides and codemods. Use when upgrading Next.js versions, running codemods, or migrating between major releases.\nmetadata:\n  priority: 6\n  docs:\n    - \"https://nextjs.org/docs/app/guides/upgrading\"\n    - \"https://nextjs.org/docs/app/guides/upgrading/codemods\"\n  pathPatterns:\n    - 'next.config.*'\n    - 'package.json'\n  bashPatterns:\n    - '\\bnpx\\s+@next/codemod\\b'\n    - '\\bnpm\\s+(install|i|add)\\s+[^\\n]*\\bnext@'\n    - '\\bpnpm\\s+(install|i|add)\\s+[^\\n]*\\bnext@'\n    - '\\bbun\\s+(install|i|add)\\s+[^\\n]*\\bnext@'\n    - '\\byarn\\s+add\\s+[^\\n]*\\bnext@'\n  promptSignals:\n    phrases:\n      - \"upgrade next\"\n      - \"upgrade nextjs\"\n      - \"migrate next\"\n      - \"update next.js\"\n      - \"next.js upgrade\"\n      - \"nextjs migration\"\n      - \"next codemod\"\n    allOf:\n      - [upgrade, next]\n      - [migrate, next]\n      - [update, nextjs]\n    anyOf:\n      - \"breaking changes\"\n      - \"codemod\"\n      - \"migration guide\"\n      - \"version upgrade\"\n    noneOf: []\n    minScore: 6\n---\n\n# Upgrade Next.js\n\nUpgrade the current project to the latest Next.js version following official migration guides.\n\n## Instructions\n\n1. **Detect current version**: Read `package.json` to identify the current Next.js version and related dependencies (React, React DOM, etc.)\n\n2. **Fetch the latest upgrade guide**: Use WebFetch to get the official upgrade documentation:\n   - Codemods: https://nextjs.org/docs/app/guides/upgrading/codemods\n   - Version-specific guides (adjust version as needed):\n     - https://nextjs.org/docs/app/guides/upgrading/version-16 \n     - https://nextjs.org/docs/app/guides/upgrading/version-15\n     - https://nextjs.org/docs/app/guides/upgrading/version-14\n\n3. **Determine upgrade path**: Based on current version, identify which migration steps apply. For major version jumps, upgrade incrementally (e.g., 13 → 14 → 15).\n\n4. **Run codemods first**: Next.js provides codemods to automate breaking changes:\n   ```bash\n   npx @next/codemod@latest <transform> <path>\n   ```\n   Common transforms:\n   - `next-async-request-api` - Updates async Request APIs (v15)\n   - `next-request-geo-ip` - Migrates geo/ip properties (v15)\n   - `next-dynamic-access-named-export` - Transforms dynamic imports (v15)\n\n5. **Update dependencies**: Upgrade Next.js and peer dependencies together:\n   ```bash\n   npm install next@latest react@latest react-dom@latest\n   ```\n\n6. **Review breaking changes**: Check the upgrade guide for manual changes needed:\n   - API changes (e.g., async params in v15)\n   - Configuration changes in `next.config.js`\n   - Deprecated features being removed\n\n7. **Update TypeScript types** (if applicable):\n   ```bash\n   npm install @types/react@latest @types/react-dom@latest\n   ```\n\n8. **Test the upgrade**:\n   - Run `npm run build` to check for build errors\n   - Run `npm run dev` and test key functionality\n"},"changes":[{"path":"/included_files","type":"changed","before":[],"after":[{"relative_path":"agents/openai.yaml","size_in_bytes":120}]}],"summary":"Fields changed: 1. /included_files.","summary_kind":"deterministic","summary_metadata":{}}