Agent skill

update

Update assistant-ui and AI SDK to latest versions. Detects current versions, identifies breaking changes, and executes migrations.

View SKILL.md on GitHub Repository
Stars 12
Forks 2

Install this agent skill to your Project

npx add-skill https://github.com/assistant-ui/skills/tree/main/update

SKILL.md

assistant-ui Update

Always verifies against npm ground truth and GitHub commits.

References

  • ./references/ai-sdk-v6.md -- AI SDK v4/v5 → v6 migration (complete guide)
  • ./references/assistant-ui.md -- assistant-ui version migrations
  • ./references/breaking-changes.md -- Quick reference table

Phase 1: Detect Versions

Get Ground Truth

bash
# Installed versions
npm ls @assistant-ui/react @assistant-ui/react-ai-sdk ai @ai-sdk/react 2>/dev/null

# Latest from npm
npm view @assistant-ui/react version
npm view @assistant-ui/react-ai-sdk version
npm view ai version

Version Analysis

Package Check For
ai < 6.0.0 → needs AI SDK v6 migration
@assistant-ui/react < 0.12.0 → needs unified state API migration
@assistant-ui/react < 0.11.0 → needs runtime migration
@assistant-ui/react < 0.10.0 → needs ESM migration
@assistant-ui/react < 0.8.0 → needs UI split migration
@assistant-ui/react-ai-sdk < 1.0.0 → needs AI SDK v6 first

Phase 2: Route to Migration

AI SDK < 6.0.0?
├─ Yes → See ./references/ai-sdk-v6.md
└─ No
   └─ assistant-ui outdated?
      ├─ Yes → See ./references/assistant-ui.md
      └─ No → Already up to date

Migration Order

  1. AI SDK first (if < 6.0.0) - Required for @assistant-ui/react-ai-sdk >= 1.0
  2. assistant-ui second - Apply breaking changes for version jump
  3. Verify - Type check, build, test

Phase 3: Execute

Update Packages

bash
# pnpm
pnpm add @assistant-ui/react@latest @assistant-ui/react-ai-sdk@latest ai@latest @ai-sdk/react@latest

# npm
npm install @assistant-ui/react@latest @assistant-ui/react-ai-sdk@latest ai@latest @ai-sdk/react@latest

Apply Migrations

Based on version jump, apply relevant migrations from references.

Verify

bash
npx tsc --noEmit  # Type check
pnpm build        # Build check

Troubleshooting

"Peer dependency conflict"

  • Update all packages together
  • Check version compatibility in ./references/breaking-changes.md

Type errors after upgrade

  • Consult breaking changes reference
  • Check specific migration guide

Runtime errors

  • Verify API patterns match new version
  • Check for renamed/moved APIs

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

assistant-ui/skills

primitives

Guide for assistant-ui UI primitives - ThreadPrimitive, ComposerPrimitive, MessagePrimitive. Use when customizing chat UI components.

12 2
Explore
assistant-ui/skills

assistant-ui

Guide for assistant-ui library - AI chat UI components. Use when asking about architecture, debugging, or understanding the codebase.

12 2
Explore
assistant-ui/skills

tools

Guide for tool registration and tool UI in assistant-ui. Use when implementing LLM tools, tool call rendering, or human-in-the-loop patterns.

12 2
Explore
assistant-ui/skills

streaming

Guide for assistant-stream package and streaming protocols. Use when implementing streaming backends, custom protocols, or debugging stream issues.

12 2
Explore
assistant-ui/skills

thread-list

Guide for multi-thread management in assistant-ui. Use when implementing thread lists, switching threads, or managing conversation history.

12 2
Explore
assistant-ui/skills

setup

Setup and configure assistant-ui in a project. Use when installing packages, configuring runtimes, setting up chat UI, or troubleshooting setup issues.

12 2
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results