🌱 Empieza aquí · Auditor de usabilidad (Nielsen + Krug)
¿Alguna vez sentiste que tu landing "no jala" o que un formulario confunde a la gente, pero no supiste explicar por qué? Esta semilla le enseña a tu asistente a revisar cualquier interfaz con el ojo de un experto en usabilidad: le pasa dos marcos formales (las 10 heurísticas de Jakob Nielsen y las leyes de Steve Krug), y a partir de ahí te dice qué falla, qué tan grave es (de 0 a 4) y cómo arreglarlo, con un puntaje global de 0 a 10. Menos "esto se siente raro", más "esto falla aquí y así se corrige".
Para instalarla
Abre esta carpeta con Claude Code o Cowork y dile a tu asistente:
"Siembra esta semilla 🌱"
Con eso basta de tu parte. Tu asistente hace el resto y al final te dice cómo comprobar que quedó. Vas a ver algunas palabras en inglés en la pantalla; ni caso, él te guía.
¿Otras formas de pedírselo? "instala esta semilla", "activa el auditor de usabilidad", "haz el setup de esto". Te entiende igual.
Para el asistente que siembra 🤖
Este componente es una skill (habilidad): un método que el asistente carga y aplica
cuando le piden revisar la usabilidad de una interfaz. No es un programa ejecutable ni un
hook (gancho de automatización): no lleva chmod, no lleva entrada en settings.json y
no ejecuta ningún script. Se "siembra" colocando el archivo del método donde tu
plataforma cargue habilidades.
1. Copia la habilidad a su lugar
El kernel trae un archivo:
kernel/SKILL.md— el método en sí (el auditor de usabilidad).
Claude Code (macOS / Linux / Windows con Git Bash):
mkdir -p "$HOME/.claude/skills/ux-heuristics"
cp kernel/SKILL.md "$HOME/.claude/skills/ux-heuristics/SKILL.md"
Las carpetas dentro de
~/.claude/skills/se cargan como habilidades disponibles. El asistente la invoca cuando detecta que le piden auditar usabilidad, revisar una landing o entender por qué un flujo no convierte.
Cowork: coloca la carpeta ux-heuristics/ (con SKILL.md dentro) en la ruta de
habilidades de tu proyecto si la soporta. Si no, guarda SKILL.md dentro del proyecto y
agrega en el archivo de instrucciones (CLAUDE.md) una línea que apunte a él: "Cuando te
pidan revisar la usabilidad de una interfaz, aplica el método de ux-heuristics/SKILL.md."
Codex: Codex lee su archivo de instrucciones AGENTS.md. Pega el contenido de
SKILL.md dentro de AGENTS.md (o agrégale un puntero al archivo si lo guardas aparte),
para que el método se cargue con el resto de las instrucciones.
2. Verificación post-siembra (obligatoria)
a) El archivo quedó colocado (ejemplo Claude Code):
ls -la "$HOME/.claude/skills/ux-heuristics/SKILL.md"; echo "exit=$?"
Salida esperada: una línea que lista el archivo (con su tamaño) y exit=0. Si sale
No such file or directory, la copia no se hizo; repite el paso 1.
b) El método se aplica (prueba de comportamiento, en una conversación nueva):
Dale al asistente una interfaz para revisar —puede ser una captura de pantalla, el enlace
de una landing o la descripción de un formulario— y pídele: "audita la usabilidad de
esto". La conducta correcta es que te devuelva un score global de 0 a 10 y una lista
de hallazgos, cada uno con su severidad (0-4) y su fix concreto, ordenados por gravedad.
Si solo te da una opinión vaga sin puntaje ni arreglos, el método no se cargó: revisa que
SKILL.md esté en la carpeta de habilidades (o dentro de AGENTS.md en Codex).
Cuando ambas partes pasen, avísale a la persona en una línea qué gana con esto.
✅ ¿Cómo sé que funcionó?
De ahora en adelante, cuando quieras saber si una pantalla tuya está bien resuelta, ya no vas a depender de una corazonada. Tu asistente te va a decir con nombre y apellido qué falla (por ejemplo, "no hay indicador de carga, severidad 3"), qué tan grave es y cómo arreglarlo, y te va a poner un puntaje de 0 a 10 para que midas el antes y el después. Es como tener a un experto en usabilidad revisando tu trabajo antes de publicarlo. 🌱