update▌
assistant-ui/skills · updated Apr 8, 2026
Automated version detection and migration for assistant-ui and AI SDK with breaking-change guidance.
- ›Detects current installed versions against npm ground truth and identifies which migrations are needed
- ›Routes updates through AI SDK v6 migration first (if required), then assistant-ui version-specific migrations, with clear dependency ordering
- ›Includes reference guides for AI SDK v4/v5 to v6 transitions, assistant-ui version jumps, and a breaking-changes quick reference table
- ›Prov
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
# 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
- AI SDK first (if < 6.0.0) - Required for @assistant-ui/react-ai-sdk >= 1.0
- assistant-ui second - Apply breaking changes for version jump
- Verify - Type check, build, test
Phase 3: Execute
Update Packages
# 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
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
Discussion
Product Hunt–style comments (not star reviews)- No comments yet — start the thread.
Ratings
4.5★★★★★45 reviews- ★★★★★Diya Menon· Dec 28, 2024
We added update from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
- ★★★★★Alexander Kapoor· Dec 16, 2024
Registry listing for update matched our evaluation — installs cleanly and behaves as described in the markdown.
- ★★★★★Harper Singh· Dec 12, 2024
update reduced setup friction for our internal harness; good balance of opinion and flexibility.
- ★★★★★Xiao Gonzalez· Nov 19, 2024
update reduced setup friction for our internal harness; good balance of opinion and flexibility.
- ★★★★★Naina Nasser· Nov 7, 2024
update fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
- ★★★★★Tariq Park· Nov 3, 2024
We added update from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
- ★★★★★Ishan Garcia· Oct 26, 2024
We added update from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.
- ★★★★★Xiao Thompson· Oct 22, 2024
update fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.
- ★★★★★Xiao Smith· Oct 10, 2024
Registry listing for update matched our evaluation — installs cleanly and behaves as described in the markdown.
- ★★★★★Sakshi Patil· Sep 21, 2024
I recommend update for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.
showing 1-10 of 45