update
Upgrades an existing assistant-ui project to current releases and executes the resulting migrations. Use when the user wants to update, upgrade, bump, or migrate @assistant-ui/react, @assistant-ui/react-ai-sdk, ai, or @ai-sdk/react, hits peer-dependency conflicts or post-upgrade type errors, or must apply renamed APIs after a version jump. Detects installed versus latest versions via npm ls / npm view, then routes through breaking-change references for each jump (AI SDK v4/v5 to v6; assistant-ui
Security Assessment
About update
The update skill is a specialized tool for upgrading existing assistant-ui projects to their latest releases and executing necessary migrations. It addresses the common challenge developers face when updating @assistant-ui/react, @assistant-ui/react-ai-sdk, ai, and @ai-sdk/react packages, particularly when dealing with peer dependency conflicts, breaking changes across major version jumps, or post-upgrade type errors. The skill intelligently detects current and available versions using npm, then routes users through the appropriate breaking-change references based on their specific version gap.
This skill handles complex migration scenarios including the AI SDK v4/v5 to v6 transition and assistant-ui upgrades from 0.8.x through 0.14.x. It systematically addresses API renames and deprecations such as useAssistantApi to useAui, runtime.threadList to runtime.threads, the removal of ThreadPrimitive.ViewportSlack, primitives components prop migration to children render functions, toDataStreamResponse to toUIMessageStreamResponse, and maxSteps to stopWhen patterns. The skill executes package updates, applies code transformations, and verifies the results through TypeScript compilation checks.
Target users include developers maintaining assistant-ui applications who need to stay current with framework updates, teams encountering peer dependency conflicts during routine maintenance, and projects that have fallen behind on updates and need to navigate multiple breaking changes. The skill is particularly valuable for developers who want a systematic, verified approach to upgrades rather than manual migration that might miss subtle API changes or compatibility requirements.
FAQ
When should I use the update skill versus the setup skill?
Use the update skill when you have an existing assistant-ui project that needs upgrading to newer versions. Use the setup skill for first-time installations or creating a fresh scaffold from scratch.
What if I'm upgrading from a very old version with multiple breaking changes?
The skill detects your current version against the latest available and routes you through the appropriate migration path. It handles AI SDK migrations first (if needed), then applies assistant-ui breaking changes systematically based on your version jump.
How does the skill verify that my upgrade was successful?
After applying package updates and migrations, the skill runs TypeScript type checking (npx tsc --noEmit) and build verification to catch type errors or compatibility issues before runtime.
What should I do if I encounter peer dependency conflicts?
The skill recommends updating all related packages together (@assistant-ui/react, @assistant-ui/react-ai-sdk, ai, @ai-sdk/react) to ensure version compatibility. It also provides a breaking changes reference to check compatibility requirements.
Does this skill handle AI SDK version 6 migrations?
Yes, the skill includes comprehensive AI SDK v4/v5 to v6 migration support through dedicated reference documentation, handling API renames and changes required for compatibility with assistant-ui 1.0+.
Install update
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
assistant-ui/skills