CommunityImagengithub.com

Isometrics (Estilo lineal)

Dibuja y anima objetos isométricos de estilo lineal en React + SVG para estados vacíos, bloqueados e ilustraciones puntuales, con matemática isométrica exacta, contorno de 1 píxel, una marca de la empresa y un movimiento, verificado mediante renderizado y capturas de pantalla.

¿Qué es Isometrics (Estilo lineal)?

Esta habilidad para agentes de IA genera ilustraciones y objetos isométricos completos y animados en estilo lineal para interfaces de usuario, especialmente diseñados para estados vacíos, bloqueados o ilustraciones puntuales. El agente transforma una solicitud breve (como "isométrica de una galería vacía") en un componente React funcional que incluye la ilustración, un encabezado, un texto descriptivo y un botón. Todo el proceso se rige por reglas estrictas: se utilizan primitivas 3D en unidades de mundo real proyectadas en isométrica verdadera (ejes a 30°), un contorno de 1 píxel sobre caras blancas como papel, una única marca pequeña del color de la empresa y un solo movimiento ("beat") animado que se reproduce una vez al entrar en escena. El agente sigue un flujo de trabajo de 5 etapas: análisis del briefing, propuesta de tres conceptos, descomposición del objeto en partes, definición del movimiento y construcción, renderizado y verificación con un script que comprueba líneas limpias, consistencia visual y ausencia de errores. La habilidad está pensada para proyectos que usan React, Tailwind CSS, shadcn/ui y la librería `motion`, y la verificación se realiza con Playwright. El agente no puede omitir etapas ni dar un objeto por terminado hasta que pase todas las comprobaciones.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/craftUI012/Skills/tree/main/isometrics

Installed? Explore more Imagen skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿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

ArchivoLéelo
SKILL.mdsiempre: el flujo de trabajo y las reglas
references/brief-to-concept.mdetapa 1–2: convertir un briefing vago en tres conceptos
references/motion.mdetapa 4: elegir y sincronizar el movimiento
references/line-style.mdetapa 3–5: cada regla de dibujo, lo que se debe y no se debe hacer, con la razón
references/engine-api.mdmientras se construye: el motor y el kit de línea
references/isometric-math.mdcuando una forma necesita matemáticas que el motor no tiene
examples/*.tsxantes de construir: empezar desde el más cercano
engine/iso-core.tsx, engine/iso-line.tsxse copian una vez en el proyecto del usuario
scripts/check.mjsetapa 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.

  1. Comprueba si existe components/isometrics/iso-core.tsx. Si falta, copia engine/iso-core.tsx y engine/iso-line.tsx de esta habilidad a components/isometrics/ (o la carpeta que prefiera el usuario; los objetos los importan de forma relativa, por lo que todos viven en una misma carpeta).

  2. 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.

  3. Para el verificador, Playwright: npm i -D playwright y npx playwright install chromium (o usa un Chrome instalado).

  4. Una página para renderizar un objeto solo, envuelto en PlayOnHover (el verificador lo ejecuta al pasar el ratón), por ejemplo app/isometrics-preview/<nombre>/page.tsx en 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:

ObjetoMensaje (encabezado)El único movimiento
A ★………
B………
C………

Cada concepto debe superar las cuatro pruebas:

  1. Se lee en contorno a 120 px. Una silueta que la gente reconoce sin color.
  2. 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.
  3. 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).
  4. 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) usan view="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

  1. Empieza desde el ejemplo más cercano en examples/ (tabla abajo). Mantén su estructura: storyboard, TIMING, geometría, pistas, poses, piezas, LineState.

  2. 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 en lines-marked.png);
    • que su tamaño óptico coincide con el conjunto (√(an×al) 140–175 px).
  3. Observa sheet.png y lines.png (ábrelos ambos) y revisa la lista de verificación a continuación. El verificador no puede ver el diseño; tú sí.

  4. 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.

  5. 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.

ErrorRegla ahora
Los cubos dibujados de frente parecían pegatinas planasElige 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 suciasSin 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 conjuntoTamaño óptico 140–175 px mediante defaultArtClassName
Las páginas volaban 3 unidades fuera del marcoEl 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 caraBusca caras accidentales al tamaño de miniatura
Un giro de esquina hacia el espectador era invisible de frenteLos 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étricoEn 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ónLas 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 finoLas paredes robustas tienen grosor (≥ 0.5); las caras finas son para papel
Cada objeto se veía bien solo, el conjunto noRevisa 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 curvasDe 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 gruesaEl contenido se sienta dentro de una pared interior, nunca en el contorno del contenedor
Una puerta 0.25 prominente de su caja doblaba el arcoUna 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 cantoLas 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 doblesEstablece 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íneaDibuja las marcas como formas con espacios claros; evita glifos de espacio en el texto

Reglas no negociables

  1. 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°).
  2. Geometría primero. Coloca las primitivas en unidades de mundo. Nunca escribas a mano una ruta de pantalla proyectada.
  3. Una cuadrícula. Posiciones y tamaños en unidades de mundo de 0.5; detalles de cara en 0.25.
  4. 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.
  5. 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 sigue tone (predeterminado primary).
  6. 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 contenido title: es el nombre accesible.
  7. Accesible e incrustable. El arte es decorativo a menos que title esté establecido.

Skills relacionados