Download for macOS
Skill

heroui-migration

@heroui-inc Updated 2026-10-18

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.

component-librarycomponentslibraryreactjs

Install

With your agent

Install OMGSkills skill "heroui-inc/heroui:heroui-migration" into this agent's normal skills directory: use the OMGSkills MCP get_skill tool, install only the pinned_install commit and path, verify SKILL.md against pinned_install.skill_md_sha, and stop if MCP or the pin is unavailable. Do not overwrite or change existing skills without asking me.

Manual command

git clone https://github.com/heroui-inc/heroui /tmp/heroui && ln -s /tmp/heroui/skills/heroui-migration ~/.claude/skills/heroui-migration

From README

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. --- --- 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 | required | No Provider needed | | Component API | Flat props: | Compound: | | Event handlers | onClick | onPress | | Styling | classNames prop | className prop | | Hooks | useSwitch, useDisclosure, etc.