Setting the skill. One moment.
Skills
Skill 8 of 12
Context for working on the next AI SDK major release. Only use when explicitly invoked by the user (e.g. via ‘/major-version-mode’).
2 minutes · 389 words · 6 sections
Install
npx skills add vercel/ai --skill major-version-modenpx skills add vercel/aiThe first command installs just this skill, by the name in its SKILL.md; the second installs the whole repository.
This task is part of the next AI SDK major release. Breaking changes are acceptable.
While breaking changes are acceptable, it is still encouraged to minimize unnecessary disruption for 3P consumers of the AI SDK. Providing deprecated aliases and automated migration logic can help ease the transition.
If renaming or modifying an exported function or type, provide a deprecated alias as a package-level export where feasible:
/** @deprecated Use `newFunctionName` instead. */
export { newFunctionName as oldFunctionName } from './new-module';Only do this if it doesn’t introduce meaningful technical debt. If it does, skip the alias — but check with the user first before making a clean break.
If modifying model message shapes (e.g. content part types in packages/provider-utils/src/types/content-part.ts):
@ai-sdk/provider-utils rather than removing immediately, if feasible. Mark deprecated types/members with a @deprecated JSDoc comment and a TODO note to remove in the following major version.packages/ai/src/prompt/content-part.ts — this file is the consumer-facing layer and should retain the old shapes in the Zod schemas so existing consumer code continues to compile with a deprecation warning. Include a similar note about deprecation and removal in the following major version.The provider package defines the spec that provider implementers code against. It should generally not be modified outside of major versions, so keeping the spec clean and consistent is critical.
Breaking changes without maintaining temporary backward compatibility measures are more acceptable here than elsewhere, because the audience is smaller — far fewer developers implement their own providers than build features on top of the AI SDK.
Rules:
After implementing changes, update relevant documentation in content/docs/.
If the change requires consumers to update their code or migrate stored data, add a section to the latest migration guide:
content/docs/08-migration-guides/Context for working on the next AI SDK major release. Only use when explicitly invoked by the user (e.g. via '/major-version-mode'). Do NOT trigger autonomously based on task content.
The verbatim description from this skill’s front matter — the string an agent matches on to decide whether to load it.
main, last pushed 24 September 2026.SKILL.md, not by matching a directory convention. One layout observed: skills/*/SKILL.md./vercel/ai.md, and each skill at its own .md URL.