Agent Skills

Enable AI assistants to migrate HeroUI v2 to v3

HeroUI Migration Skills give your AI assistant comprehensive knowledge of HeroUI v2 to v3 migration workflows, component guides, and best practices.

Installation

1curl -fsSL https://heroui.com/install | bash -s heroui-migration

Or using the skills package:

1npx skills add heroui-inc/heroui

Support Claude Code, Cursor, OpenCode and more.

Install Scope

By default the install script writes to your home directory, so the skill is available in every project. Add HEROUI_SKILL_SCOPE=project and rerun it from the project you're migrating to install there instead — useful when you only need the migration skill for that codebase.

1curl -fsSL https://heroui.com/install | HEROUI_SKILL_SCOPE=project bash -s heroui-migration

Each detected tool gets the directory it reads from, inside the project: .claude/skills/ for Claude Code, .cursor/skills/ for Cursor, .opencode/skills/ for OpenCode, and .agents/skills/ for Codex and Antigravity.

Usage

Skills are automatically discovered by your AI assistant, or call it directly using /heroui-migration command.

Simply ask your AI assistant to:

Migrate components from HeroUI v2 to v3
Get the full or incremental migration workflow
Fetch component-specific migration guides
Access hooks and styling migration documentation

What's Included

Migration workflows (full and incremental)
Component-specific migration guides (39 components)
Hooks migration guide (useDisclosure → useOverlayState, etc.)
Styling migration guide (utility classes, color tokens, CSS variables)
Key API changes and compound component patterns

Structure

1skills/heroui-migration/2├── SKILL.md                    # Main skill documentation3├── LICENSE.txt                 # Apache License 2.04└── scripts/                    # Utility scripts5    ├── list_migration_guides.mjs6    ├── get_migration_guide.mjs7    ├── get_component_migration_guides.mjs8    ├── get_styling_migration_guide.mjs9    └── get_hooks_migration_guide.mjs