Agent skill · software engineering · heroui-inc
heroui-migration
HeroUI v2 to v3 migration guide for agents. Use when migrating HeroUI v2 apps to v3, upgrading components, or accessing migration documentation. Keywords: HeroUI migration, v2 to v3, migration guide, upgrade HeroUI.
Why this skill is useful
Adds specific migration scripts and detailed component changes that the AI wouldn't reliably generate on its own.
What it needs
Requires heroui installed locally. About 2k tokens when loaded. Last updated 2026-08-06. 30,318 stars on the source repository.
What this skill does
HeroUI v2 to v3 Migration Guide This skill helps agents migrate HeroUI v2 applications to v3. HeroUI v3 introduces breaking changes: compound components, no Provider, Tailwind v4, and removed hooks. --- Installation --- CRITICAL: Always Fetch Migration Docs Before Applying Do NOT assume v2 patterns work in v3. Always fetch migration guides before implementing changes. Key v2 → v3 Changes Feature v2 (Migrate From) v3 (Migrate To) ------------- -------------------------- -------------------------------------- Provider <HeroUIProvider> required No Provider needed Component API Flat props: <Card title="x"> Compound: <Card><Card.Header> Event handlers onClick onPress Styling classNames prop className prop Hooks useSwitch, useDisclosure, etc. Compound components, useOverlayState Packages @heroui/system, @heroui/theme @heroui/react, @heroui/styles --- Accessing Migration Documentation For migration details, examples, and step-by-step guides, always fetch documentation: Using Scripts Direct URLs Migration docs (preview): use a concrete guide URL from the examples below, and never fetch a URL that still contains a placeholder. Examples: Full migration: .../agent-guide-full.mdx Incremental: .../agent-guide-incremental.mdx Button: .../button.mdx Styling: .../styling.mdx Hooks: .../hooks.mdx Override base URL with HEROUIMIGRATIONDOCSBASE when docs are merged to production. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills heroui-inc/heroui-migration