¿Qué hace Isometrics (Estilo lineal)?
Convierte una breve solicitud ("isométrica de una galería", "un buzón vacío") en un objeto dibujado y animado que se entrega como un estado completo: la ilustración, un encabezado, una línea de texto y un botón. Cada objeto se construye a partir de primitivas 3D en unidades de mundo y se proyecta en isométrica verdadera, de modo que comparte una cuadrícula, un contorno y un aspecto con cualquier otro objeto creado con esta habilidad.
El aspecto, en una línea: un objeto, de frente si es plano o en ángulo isométrico verdadero si es voluminoso, un contorno de 1 píxel sobre caras blancas como papel, una pequeña marca del color de la empresa, sin sombra, sin resplandor, un movimiento y luego quietud.
No se saltan etapas. No se da un objeto por terminado hasta que el verificador pasa y has examinado su hoja.
Contenido
| Archivo | Léelo |
|---|---|
SKILL.md | siempre: el flujo de trabajo y las reglas |
references/brief-to-concept.md | etapa 1–2: convertir un briefing vago en tres conceptos |
references/motion.md | etapa 4: elegir y sincronizar el movimiento |
references/line-style.md | etapa 3–5: cada regla de dibujo, lo que se debe y no se debe hacer, con la razón |
references/engine-api.md | mientras se construye: el motor y el kit de línea |
references/isometric-math.md | cuando una forma necesita matemáticas que el motor no tiene |
examples/*.tsx | antes de construir: empezar desde el más cercano |
engine/iso-core.tsx, engine/iso-line.tsx | se copian una vez en el proyecto del usuario |
scripts/check.mjs | etapa 5: la comprobación estricta de renderizado |
Configuración (una vez por proyecto)
Los objetos son componentes cliente de React para un proyecto con Tailwind CSS
y shadcn/ui (usan @/lib/utils cn y @/components/ui/button)
y el paquete motion.
-
Comprueba si existe
components/isometrics/iso-core.tsx. Si falta, copiaengine/iso-core.tsxyengine/iso-line.tsxde esta habilidad acomponents/isometrics/(o la carpeta que prefiera el usuario; los objetos los importan de forma relativa, por lo que todos viven en una misma carpeta). -
Si el proyecto no tiene
motion: instálalo (npm i motion, o el gestor de paquetes del proyecto). Si no tiene el botón de shadcn:npx shadcn@latest add button. -
Para el verificador, Playwright:
npm i -D playwrightynpx playwright install chromium(o usa un Chrome instalado). -
Una página para renderizar un objeto solo, envuelto en
PlayOnHover(el verificador lo ejecuta al pasar el ratón), por ejemploapp/isometrics-preview/<nombre>/page.tsxen Next.js, o una ruta en el enrutador del proyecto:import { PlayOnHover } from "@/components/isometrics/iso-line"; import { MapPin } from "@/components/isometrics/map-pin"; export default function Page() { return ( <main className="flex min-h-svh items-center justify-center p-10"> <PlayOnHover><MapPin /></PlayOnHover> </main> ); }Crea una por objeto; informa al usuario de que es una página de vista previa que puede eliminar.
Nunca edites el motor para hacer funcionar un objeto. Si realmente falta una forma, añade un helper dentro del archivo del objeto, construido a partir de 3D, y comunícalo al usuario.
El flujo de trabajo
Etapa 1 · Lee el briefing
Convierte la solicitud en tres respuestas antes que cualquier otra cosa:
- Tema: la cosa o el tema ("galería" → fotos, álbumes, imágenes).
- Uso: qué estado sirve: vacío (aún no hay nada), bloqueado (sin acceso, apagado, no conectado, no encontrado), sin resultados (búsqueda, filtros), éxito / todo claro, o una ilustración puntual en una tarjeta de funcionalidad.
- Mensaje: una frase sencilla que dice el estado ("Aún no tienes fotos").
Si el uso no está indicado, el briefing suele encajar en más de uno; para eso
están los conceptos. Consulta references/brief-to-concept.md.
Etapa 2 · Tres conceptos, luego espera
A menos que el briefing ya nombre un objeto y un estado, muestra al usuario tres conceptos como una tabla y detente y espera su elección:
| Objeto | Mensaje (encabezado) | El único movimiento | |
|---|---|---|---|
| A ★ | … | … | … |
| B | … | … | … |
| C | … | … | … |
Cada concepto debe superar las cuatro pruebas:
- Se lee en contorno a 120 px. Una silueta que la gente reconoce sin color.
- Redondeado vence a cúbico. Los objetos redondeados se leen como más amigables en línea; un cubo simple se lee como un paquete o un alámbrico.
- Un objeto. No una escena, no un montón. Una segunda parte pequeña está bien solo si pertenece al objeto (una tapa, una bandera, una mano).
- El movimiento dice el mensaje. El movimiento es el verbo de la frase
(consulta
references/motion.md). Si no puedes nombrar el movimiento, es el objeto equivocado.
Marca tu recomendación con ★ y explica por qué en una línea. Varía los tres: diferentes objetos, diferentes movimientos. Cuando el briefing es específico ("un estado de buzón vacío con una bandeja"), omite la tabla, indica tu elección y el movimiento, y continúa.
Etapa 3 · Divide el objeto en partes
Escribe una tabla de partes en unidades de mundo antes del código: cada parte, la
primitiva de la que está construida (Extrude, Slice, Ring, FacePath, Box…), su
tamaño y posición en la cuadrícula de 0.5, si se mueve, y qué parte es la
marca de la empresa. Luego el texto: encabezado (≤ 28 caracteres), una o dos
frases, etiqueta del botón (≤ 22 caracteres) y su icono (el icono sigue
al verbo: un signo más solo donde la acción añade).
Reglas que determinan las partes (todas en references/line-style.md):
- Elige la vista primero. Las cosas planas o delgadas (una página, una insignia, un disco)
usan
view="front"; las cosas voluminosas o profundas (una impresora, una caja, un servidor, una bandeja, un palo sobre un escritorio) usanview="isometric". Los cubos vistos de frente se leen como pegatinas planas con líneas dobladas. - Construye mirando hacia +y alrededor de x = 0, apoyado en z = 0.
- Tres niveles de detalle: forma, las partes por las que se reconoce, y marcas sutiles (tornillos, rejillas, costuras, una etiqueta).
- Líneas limpias: un sólido visto de frente no tiene profundidad o tiene una clara (franja ≥ ~4 px); una parte está al ras o sobresale ≥ 0.5; las pilas redondas comparten un radio con una línea de costura.
- Las cosas planas (papel, etiquetas, pantallas) son caras, no sólidos.
- Los sólidos redondos son rodajas entre círculos nivelados, pintados desde la base hacia arriba.
- Un contorno que no es convexo necesita que se dibuje su borde lejano.
- Una parte que se desliza fuera de un alojamiento se corta en el alojamiento, no flota.
- Una marca de la empresa (paleta
main); todo lo demás es papel (surface).
Etapa 4 · Elige y escribe el movimiento
Elige el movimiento a partir del mensaje (references/motion.md), luego escribe el
storyboard como comentario en la parte superior del archivo antes del código de
dibujo: tiempos, qué se mueve, cuánto, por qué. Cada valor en una constante con
nombre. El movimiento espera 400 ms después de que el arte se desplaza a la vista, dura 1.2–2.4 s y se
reproduce una vez. Cuando el código del usuario pasa active, se reproduce cada vez
que active se vuelve verdadero (con un retraso de 80 ms), nunca por sí solo. El modo de
movimiento reducido muestra la pose de reposo.
Etapa 5 · Construye, renderiza, verifica, observa, corrige
-
Empieza desde el ejemplo más cercano en
examples/(tabla abajo). Mantén su estructura: storyboard, TIMING, geometría, pistas, poses, piezas,LineState. -
Renderízalo en su página de vista previa y ejecuta el verificador:
node <skill>/scripts/check.mjs http://localhost:3000/<preview-path>/<nombre> --duration <espera+movimiento ms>Renderiza en claro y oscuro, reproduce el movimiento al pasar el ratón sobre el arte en un reloj falso (por lo que la página de vista previa debe envolver el objeto en
<PlayOnHover>), guarda fotogramas al 0, 25, 50, 75, 100 % y después, y comprueba:- sin errores de hidratación ni de consola, en claro, oscuro y movimiento reducido;
- que se reproduce cuando está activo, y que no hay ningún botón dentro del arte;
- que el movimiento se asienta exactamente de nuevo en su pose de reposo;
- que el movimiento reducido está quieto, muestra la pose de reposo, ignora
active; - que cada contorno tiene aproximadamente 1 px; sin filtros, resplandor, sombras ni pintura degradada;
- que el dibujo en reposo encaja en su marco;
- que el dibujo está centrado con el encabezado dentro de 2 px;
- líneas limpias: como máximo el 6% del contorno en dobles sostenidos (dos
líneas separadas 0.5–2 px a lo largo de una longitud real; los pequeños grumos donde las líneas
se encuentran no cuentan), en
oscuro a 4× (
lines.png, los dobles en rojo enlines-marked.png); - que su tamaño óptico coincide con el conjunto (√(an×al) 140–175 px).
-
Observa
sheet.pngylines.png(ábrelos ambos) y revisa la lista de verificación a continuación. El verificador no puede ver el diseño; tú sí. -
Corrige y ejecuta de nuevo. Como máximo tres rondas. Si algo sigue sin cumplirse después de tres, detente e informa al usuario exactamente de qué, con la hoja.
-
Informa: el concepto, el storyboard, el resultado del verificador, qué corregiste después de observar, qué sigue sin cumplirse, y la ruta de la hoja.
Observa la hoja: la lista de verificación
Se lee
- Sin el encabezado, ¿un desconocido nombraría el objeto al tamaño de una miniatura?
- Nada se lee accidentalmente como una cara (dos partes redondas sobre una curva).
- La marca de la empresa es una parte pequeña, y es la parte en la que el ojo debería posarse.
Reposa recto
- En reposo, cada vertical es vertical y cada borde está nivelado; nada se inclina, nada cuelga torcido; las segundas hojas están desplazadas, no giradas.
- La pose de reposo es igual a la pose de movimiento reducido (el verificador compara píxeles; tú verifica que se vea intencionado).
Líneas (observa lines.png: oscuro, 4×)
- Un grosor de contorno en todas partes; sin bordes doblados, sin costuras finas entre rellenos, sin bordes lejanos faltantes en contornos curvos, sin relleno asomando más allá de un contorno, sin línea que termine en el aire.
- Cada parte está al ras o claramente prominente (≥ 0.5); sin franjas finas.
Realismo
- La vista correcta: cosas planas de frente, cosas voluminosas en isométrica.
- Tres niveles: forma, partes reconocibles, marcas sutiles. ¿Alguien que posea uno diría "sí, eso es una impresora"?
- La franja superior (grosor visto desde 30° arriba) está presente en sólidos y ausente en caras delgadas.
Movimiento
- El movimiento dice el mensaje; cada movimiento es causado por el anterior (un retraso, un seguimiento, un asentamiento).
- Las partes con bisagras nunca se balancean a través de su alojamiento; las puntas nunca cruzan el reposo; los balanceos se mantienen pequeños (≤ 6° en una parte colgante, ≤ 25° en una solapa).
- Nada se desvanece; las cosas que aparecen crecen con escala.
Encaja en la página
- Centrado en el texto; el marco no está acolchado con espacio muerto.
- Se ve bien en oscuro: las caras de papel se convierten en papel oscuro, la marca de la empresa sigue siendo la marca.
Nunca más: errores que esta habilidad ha cometido
Cada uno de estos se envió una vez, se detectó en la revisión y ahora es una regla. Antes de informar de un objeto, compruébalo contra cada línea.
| Error | Regla ahora |
|---|---|
| Los cubos dibujados de frente parecían pegatinas planas | Elige la vista primero: cosas planas de frente, cosas voluminosas view="isometric" (line-style.md) |
| Franjas superiores finas, partes que apenas sobresalen y anillos escalonados dibujaron líneas dobles y sucias | Sin franjas finas; al ras o ≥ 0.5 prominentes; pilas redondas con un radio; la prueba de líneas limpias del verificador debe pasar, y observa lines.png (oscuro, 4×) |
| Los objetos eran solo un contorno ("no realistas") | Tres niveles de detalle: forma, partes reconocibles, marcas sutiles |
| Los tamaños saltaban entre objetos de un conjunto | Tamaño óptico 140–175 px mediante defaultArtClassName |
| Las páginas volaban 3 unidades fuera del marco | El movimiento se queda en el aire del arte; como máximo un poco más allá del borde del marco |
| Dos pestillos, una franja de ancho completo como "una marca de la empresa" | Una marca pequeña, realmente una |
| Una ranura sobre un punto, dos pestillos sobre una costura se leían como una cara | Busca caras accidentales al tamaño de miniatura |
| Un giro de esquina hacia el espectador era invisible de frente | Los giros hacia el espectador se leen a una fracción de su ángulo; prefiere movimientos en el plano de la imagen, o hazlos grandes (motion.md) |
| Una página inclinada en su plano se cizallaba en el ángulo isométrico | En vista isométrica, gira una parte solo alrededor de su propia normal o una bisagra en su borde (motion.md) |
| Una parte destelló su pose inicial durante un fotograma en la primera reproducción | Las partes impulsadas por el estado del reloj se reinician cuando el clip cambia y comienzan en reposo cuando se mantienen (engine-api.md) |
| Las paredes finas de la bandeja se leían como plástico fino | Las paredes robustas tienen grosor (≥ 0.5); las caras finas son para papel |
| Cada objeto se veía bien solo, el conjunto no | Revisa todo el lote lado a lado, claro y oscuro, antes de informar |
| El cuerpo de una campana, un grillete, una aguja dibujaban contornos dobles a lo largo de sus curvas | De frente, una parte curva es una cara plana (o una claramente profunda); da a una aguja lados paralelos, nunca un estrechamiento |
| La arena dibujada en el contorno de vidrio formaba una mancha gruesa | El contenido se sienta dentro de una pared interior, nunca en el contorno del contenedor |
| Una puerta 0.25 prominente de su caja doblaba el arco | Una puerta con la forma de su abertura comparte un contorno en reposo |
| Una puerta de caja fuerte a 32° en isométrica se veía de canto | Las puertas y tapas isométricas se abren ~24–26° para que su cara aún se lea |
| Un llavero se apoyaba sobre las llaves en lugar de pasar por sus agujeros ("el anillo no está dentro del llavero") | Las partes enhebradas se entrelazan: el anillo pasa detrás de cada parte en un lado de su agujero y delante en el otro (line-style.md) |
| Reducir un objeto a su tamaño trajo de vuelta las líneas dobles | Establece primero el ancho predeterminado, luego haz que las franjas sean ≥ 0.5 para objetos dibujados pequeños |
| Una insignia "!!!" falló la verificación de línea | Dibuja las marcas como formas con espacios claros; evita glifos de espacio en el texto |
Reglas no negociables
- Solo isométrica verdadera. Ejes a 30° de la horizontal, 120° de separación, escala igual. Nunca la proyección "de juego" 2:1 (26.565°).
- Geometría primero. Coloca las primitivas en unidades de mundo. Nunca escribas a mano una ruta de pantalla proyectada.
- Una cuadrícula. Posiciones y tamaños en unidades de mundo de 0.5; detalles de cara en 0.25.
- Un aspecto.
variant="ink"(predeterminado) o"line"; nunca mezcles aspectos en un objeto. Contorno de 1 px, paredes de papel, sin sombra, sin resplandor, sin degradado. - Tema a partir de tokens. Los colores provienen solo del tema shadcn del usuario
a través de las variables
--iso-*. Sin hexadecimal, sin oklch en un archivo de objeto. La marca de la empresa siguetone(predeterminadoprimary). - Props, no bifurcaciones. La copia, el tono, la variante, el grosor del trazo, los interruptores
de movimiento son props con comentarios de documentación (
LineStateProps). Nunca nombres un prop de contenidotitle: es el nombre accesible. - Accesible e incrustable. El arte es decorativo a menos que
titleesté establecido.