Guía de instalación · macOS

UI/UX Pro Max Skill
para Claude Code

Cómo instalar la skill de inteligencia de diseño de forma global, paso a paso, evitando los errores típicos de la documentación oficial.

Skill: ui-ux-pro-max  ·  CLI: uipro-cli  ·  Entorno: macOS + zsh + Claude Code

Esta guía instala la skill UI/UX Pro Max (67 estilos de UI, 161 paletas de color, tipografías y reglas de diseño por sector) en la carpeta global de Claude Code, dejándola disponible en todos tus proyectos sin reinstalar. El método oficial con --global no funciona en la versión actual del CLI, así que aquí se documenta la vía que funciona hoy.

Antes de empezar: dos cosas distintas La terminal (zsh) es donde ejecutas comandos del sistema (npm, ls, mv). Claude Code es la herramienta de IA que arrancas dentro de la terminal escribiendo claude, y es donde se activa la skill con lenguaje natural. No confundas una con otra.

1 Verificar requisitos

El CLI necesita Node.js (para instalarse) y Python 3 (motor de búsqueda interno de la skill). Comprueba ambos:

node --version
python3 --version
Resultado esperado: Node v18 o superior, y Python 3.x (3.9 sirve). Si alguno da command not found, instálalo con Homebrew: brew install node o brew install python3.

2 Instalar el CLI globalmente

Esto instala la herramienta uipro en tu sistema (todavía no la skill, solo el instalador):

npm install -g uipro-cli

Verifica que respondió:

uipro --version
Resultado esperado: un número de versión (p. ej. 2.2.3). El aviso de "new version of npm available" es inofensivo, puedes ignorarlo.

3 Instalar la skill en una carpeta temporal

El método oficial NO funciona El README dice de usar uipro init --ai claude --global, pero el CLI actual no reconoce --global y devuelve error: unknown option '--global'. Es un bug conocido del repositorio. Lo solucionamos instalando en una carpeta temporal y moviendo la skill a mano.

Crea una carpeta temporal, entra en ella e instala:

mkdir -p ~/uipro-temp
cd ~/uipro-temp
uipro init --ai claude
Resultado esperado: UI/UX Pro Max installed successfully! y la creación de .claude/skills/ui-ux-pro-max dentro de la carpeta temporal.

4 Mover la skill a la ruta global

Claude Code lee las skills globales desde ~/.claude/skills/. Creamos esa carpeta y movemos la skill ahí:

mkdir -p ~/.claude/skills
mv ~/uipro-temp/.claude/skills/ui-ux-pro-max ~/.claude/skills/
Resultado esperado: ningún mensaje. En terminal, el silencio significa éxito.
No repitas el comando mv Si ejecutas el mv dos veces, la segunda dará No such file or directory — porque la carpeta ya se movió la primera vez. Es inofensivo, pero no te asustes.

5 Verificar la instalación

Confirma que la skill está en su sitio y completa:

ls ~/.claude/skills/
ls ~/.claude/skills/ui-ux-pro-max/
Resultado esperado: el primero muestra ui-ux-pro-max; el segundo muestra data  scripts  SKILL.md. Si ves esos tres elementos, la skill está completa (incluye el motor Python y las bases de datos de estilos).

6 Limpiar y reiniciar

Borra la carpeta temporal que ya no sirve, y reinicia Claude Code para que detecte la nueva skill:

rm -rf ~/uipro-temp

Luego cierra y vuelve a abrir tu sesión de Claude Code.

7 Usar la skill

La skill se activa sola cuando pides trabajo de UI/UX. Pero recuerda: los prompts van dentro de Claude Code, no en la terminal pelada.

Terminal (zsh)

Solo comandos del sistema: npm, ls, cd, claude. Si escribes aquí un prompt en español, dará command not found.

Claude Code

Aquí escribes los prompts en lenguaje natural. La skill se activa automáticamente al detectar peticiones de diseño.

Para arrancar Claude Code, entra primero en una carpeta de proyecto (o crea una de prueba) y lanza claude:

# opción A: en un proyecto real
cd ruta/de/tu/proyecto
claude

# opción B: carpeta de prueba rápida
cd ~
mkdir prueba-uipro
cd prueba-uipro
claude

Y ya dentro de Claude Code, escribe tu petición:

Diséñame una landing para una clínica dental con estética premium
Qué hará la skill Antes de escribir código, genera un sistema de diseño completo: patrón de página, estilo de UI, paleta de color, tipografía, efectos clave y anti-patrones a evitar para ese sector concreto.
Error típico: "current working directory was deleted" Si borraste ~/uipro-temp mientras estabas dentro de ella, claude fallará porque tu terminal apunta a una carpeta que ya no existe. Solución: cd ~ y vuelve a intentarlo.

8 Comandos útiles de mantenimiento

ComandoQué hace
uipro versionsLista las versiones disponibles de la skill
uipro updateActualiza la skill a la última versión
uipro init --offlineInstala sin descargar de GitHub (usa los assets incluidos)
uipro init --forceSobrescribe archivos existentes al instalar
uipro uninstall --ai claudeDesinstala la skill de Claude Code
Para actualizar la versión global Como la instalaste a mano en ~/.claude/skills/, para actualizarla repite el proceso: uipro update o reinstala en ~/uipro-temp y vuelve a mover la carpeta sobrescribiendo la anterior.

Resumen rápido

Todo el proceso en seis líneas, para tenerlo a mano:

npm install -g uipro-cli
mkdir -p ~/uipro-temp && cd ~/uipro-temp
uipro init --ai claude
mkdir -p ~/.claude/skills
mv ~/uipro-temp/.claude/skills/ui-ux-pro-max ~/.claude/skills/
rm -rf ~/uipro-temp