# HeroUI Migration

> Use this tool when you need to migrate HeroUI v2 or NextUI projects to HeroUI v3 beta, as it streamlines the upgrade process by scanning codebases, analyzing legacy patterns, and applying automated rewrites. It solves problems related to manual migration efforts, reducing errors and saving time. The tool takes in codebases and imports, and outputs a reviewed and rewritten codebase with generated documentation and flagged areas for manual review.

Canonical page: https://skillsregistry.net/skills/sctg-development-heroui-migration  
JSON: https://api.skillsregistry.net/v1/skills/sctg-development-heroui-migration

## Description

Provides a controlled, review-first migration workflow for upgrading HeroUI v2 and NextUI projects to HeroUI v3 beta. Scans codebases to identify files using legacy patterns, analyzes imports, components, props, and hooks for migration impact, and applies heuristic rewrites for safe patterns while flagging areas needing manual review. Includes component comparison between v2 and v3, Tailwind configuration auditing, and a generated documentation corpus for migration reference.

## Trust

- **Trust score (0–1):** 0.63
- **Verification tier:** scanned
- **Last scanned:** 2026-09-02

## Facts

- **Version:** 1.0.0
- **Skill type:** atomic
- **Execution layer:** mcp-remote
- **Runtime environment:** api
- **Category:** file-system
- **Updated:** 2026-09-02

## Source

- **Source listing:** [PulseMCP](https://www.pulsemcp.com/servers/sctg-development-heroui-migration)
- **Repository:** <https://github.com/sctg-development/heroui-migration-mcp>

## Use it

Resolve this record through the SkillsRegistry MCP server (no auth, read-only):

```
claude mcp add --transport http --scope user skillsregistry https://api.skillsregistry.net/mcp
```

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_skill",
    "arguments": {
      "slug": "sctg-development-heroui-migration"
    }
  }
}
```

REST: `GET https://api.skillsregistry.net/v1/skills/sctg-development-heroui-migration` · pull for local use: `GET https://api.skillsregistry.net/v1/skills/sctg-development-heroui-migration/pull`

---
SkillsRegistry indexes agent skills from public registries and GitHub. Skills we have analysed are scanned with Circle-IR and scored on six dimensions; each listing states its scan coverage. More: https://skillsregistry.net/llms.txt