# Agent Skills · HeroUI

> Enable AI assistants to migrate HeroUI v2 to v3

- Page: https://jiguang132.com/systems/heroui/docs/migration/agent-skills
- Based on: HeroUI documentation (Apache-2.0) @ 60edd8ed751b1d2a270623fbb182bbcfa8baa9af

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

### Installation

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

Or using the skills package:

```bash
npx skills add heroui-inc/heroui
```


Support Claude Code, Cursor, OpenCode and more.


### 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

```
skills/heroui-migration/
├── SKILL.md                    # Main skill documentation
├── LICENSE.txt                 # Apache License 2.0
└── scripts/                    # Utility scripts
    ├── list_migration_guides.mjs
    ├── get_migration_guide.mjs
    ├── get_component_migration_guides.mjs
    ├── get_styling_migration_guide.mjs
    └── get_hooks_migration_guide.mjs
```

## Links

- [GitHub Repository](https://github.com/heroui-inc/heroui)
- [Discord Community](https://discord.gg/9b6yyZKmH4)
- [Agent Skills](https://agentskills.io/) - Learn about the Agent Skills format

---

Index of all JGuang resources: https://jiguang132.com/llms.txt