Communitygithub.com

turtleneck

Skill de diseño para interfaces web y de apps que detecta qué se está construyendo y selecciona un preset visual predefinido. Ideal para construir, rediseñar o revisar páginas web, landings, dashboards, componentes y prototipos.

¿Qué es turtleneck?

turtleneck es una habilidad de diseño para agentes de IA (como Claude Code, Cursor o Codex) que permite seleccionar y aplicar la apariencia visual adecuada para cualquier interfaz web o de aplicación. Su funcionamiento comienza con la detección automática del tipo de proyecto (página de aterrizaje, dashboard, documentación, tienda, etc.) y la industria a la que pertenece, para luego elegir uno de los presets visuales predefinidos: keynote (por defecto, aspecto premium y limpio), enterprise, cinema, vibe, power, devtool, lab, journey, market, vault o drive. Cada preset es una combinación de cinco sitios de referencia grandes de su categoría, no una copia de ninguno de ellos. La habilidad proporciona recetas listas para usar en HTML/CSS simple, Tailwind (v3/v4 con shadcn) y SwiftUI. Es útil para tareas como "haz que se vea como Apple", "estilo Netflix", "parecido a Stripe/Vercel/GitHub" o "página de producto IA". Respeta los sistemas de diseño existentes del proyecto y aplica reglas estrictas de tipografía fluida, color (siempre AA accesible), diseño responsive (probado en múltiples anchos), componentes consistentes y rendimiento. El flujo de trabajo incluye detectar el tipo de app, cargar el preset, escribir un plan de página, redactar el copy y verificar en todos los tamaños de pantalla antes de finalizar.

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/n-stau/turtleneck/tree/main/skills/turtleneck

Preguntar en tu IA favorita

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

Documentación

¿Qué hace turtleneck?

Elige el aspecto adecuado para la aplicación, luego constrúyela con disciplina. Cada aspecto es un preset: un archivo de anulación de variables sobre un núcleo compartido. El preset predeterminado, keynote, es el núcleo mismo. Cada otro preset es una combinación de cinco sitios grandes de una categoría, nunca una copia de uno de ellos.

Cuando esta habilidad está activa, anula las habilidades genéricas de "evitar valores predeterminados de IA" (como frontend-design) donde discrepan: en keynote, la fuente del sistema, las cejas en mayúscula/minúscula de oración y los titulares con degradado tonal son correctos.

Archivos junto a este:

  • tokens.css: el núcleo y los valores de keynote. Cada color es light-dark(light, dark); color-scheme en :root, .a-dark, .a-light o data-theme elige la mitad. Todos los hooks de preset están listados en su :root. Los componentes compartidos también viven ahí: escala tipográfica, botones, mosaicos, .a-grid, .a-rail, .a-stats, .a-reveal.
  • styles/<preset>.css: anulaciones de variables más algunas reglas solo del preset. Se carga después de tokens.css.
  • styles/<preset>.md: una página por preset: cuándo usarlo, tabla de tokens, reglas, deltas de componentes, fuentes, evitar, lista de verificación.
  • recipes-html.md: esqueleto de página, navegaciones, héroe, mosaicos, bento, galería, comparar, pie de página (acordeón en teléfonos), revelar y los patrones de preset compartidos (bandas invertidas, héroe de búsqueda, raíles, tabla de especificaciones, tarjetas de planes, marco de código).
  • tailwind.md, swiftui.md: los mismos tokens para esas pilas.
  • test-widths.html?src=<url>[&h=800][&full=1]: la página a 320/375/414 lado a lado con un informe de desbordamiento; full=1 aumenta cada marco a la altura de su documento para capturas de pantalla de página completa en teléfono.
  • example.html y ../../demos/ en el repositorio agent-skills: páginas terminadas.

Paso 0: Detectar el tipo de aplicación (obligatorio, antes de cualquier código)

  1. Un sistema de diseño existente o una solicitud de estilo explícita gana. Tokens del proyecto, un tema de librería de componentes, una guía de marca, o "hazlo oscuro y rojo": usa eso, conserva solo las reglas principales a continuación, omite la tabla.
  2. Lee las señales: la solicitud; README; dependencias (package.json, pyproject.toml, Podfile, Package.swift, Gemfile, *.csproj); rutas; CSS existente; la categoría del producto y la audiencia.
  3. Elige UN preset:
CategoríaSeñales (solicitud, producto, deps, rutas)Preset
Hardware premiumProducto físico, dispositivo de consumo, gadget de estilo de vida, página de lanzamiento, "limpio", "minimalista", "premium"; pantallas de marketing SwiftUI; sin señal clarakeynote
Software empresarialOficina/productividad, B2B, CRM/ERP, intranet, TI/cumplimiento, salud; deps @fluentui/*, @microsoft/teams-js, office-addin-*, @azure/*, Blazor/.NET; rutas /admin, /settings, /reportsenterprise
StreamingVideo, cine/TV, series, avances, eventos en vivo, VOD; deps hls.js, video.js, shaka-player, @mux/*, react-player; rutas /watch, /browse, /titlecinema
Música y redesMúsica/audio, listas de reproducción, creadores, feed social, citas, clases de fitness, suscripción juvenil; deps howler, tone, wavesurfer.js, expo-av; rutas /player, /playlist, /profilevibe
Hardware gamingGPU/partes de PC, consolas, periféricos, esports, benchmarks, drivers, "FPS"; deps three, @react-three/fiber + librerías de gráficos; rutas /specs, /compare, /driverspower
Desarrollador y cloudAPI, SDK, CLI, hosting, deploy, base de datos, observabilidad, API de pagos, "para desarrolladores"; deps next, @radix-ui/*, stripe, prisma, drizzle, trpc, turbo; rutas /docs, /changelog, /pricingdevtool
IAModelo, asistente, chat, agentes, "potenciado por IA" como el producto; deps openai, @anthropic-ai/sdk, ai, langchain, transformers; rutas /chat, /research, /modelslab
ViajesEstancias, vuelos, viajes, hoteles, reservas, itinerarios; selectores de fecha, mapas (leaflet, mapbox-gl); rutas /search, /stays, /trips, /bookjourney
RetailTienda, comercio, catálogo, marketplace, carrito, pago, ofertas, comestibles, moda; deps @shopify/*, @medusajs/*, @commercetools/*, snipcart, @stripe/stripe-js con un catálogo de productos; rutas /shop, /products, /p/, /cart, /checkout, /categorymarket
FinanzasBanco, tarjeta de crédito, pagos, billetera, seguros, préstamos, ahorros, inversiones, dashboard de cuentas para consumidores; deps plaid, react-plaid-link, @adyen/*, dinero.js, currency.js; rutas /accounts, /cards, /rates, /apply, /transfer (una API de pagos vendida a desarrolladores es devtool)vault
AutomotrizCoches, motos, bicicletas eléctricas, carga de vehículos eléctricos, movilidad, concesionarios, pruebas de manejo; configuradores, páginas de autonomía y especificaciones; rutas /models, /configure, /inventory, /test-drive, /dealersdrive
Tipo de páginaPreset (desempate)
Sitio de documentación, changelogdevtool
Dashboard de administraciónenterprise para usuarios empresariales; devtool para orientado a desarrolladores
Tiendamarket; una página de producto premium única es keynote
Portafoliokeynote para trabajo de producto/diseño; cinema para cine, foto, movimiento
Pantalla de app móvilkeynote para utilidades con sensación nativa; vibe para medios de consumo y redes sociales
Juego / estudio de juegospower para competitivo y orientado a hardware; cinema para juegos con historia, avances
Funcionalidad de IA dentro de otro productola categoría del propio producto; lab solo cuando la IA es el producto
Flujo de reserva dentro de otro productojourney solo para las páginas de búsqueda y resultados

Las palabras de estilo del usuario se asignan directamente: "similar a Apple / premium / limpio" = keynote; "Microsoft / Fluent" = enterprise; "estilo Netflix" = cinema; "similar a Spotify / TikTok" = vibe; "gaming / similar a NVIDIA" = power; "estilo Stripe / Vercel / GitHub" = devtool; "similar a OpenAI / Anthropic" = lab; "similar a Airbnb / Booking" = journey; "similar a Amazon / IKEA" = market; "similar a banca / PayPal" = vault; "similar a Tesla / BMW" = drive. El resultado es la combinación de la categoría, nunca el sitio de esa empresa (ver "Marcas comerciales y activos").

  1. Señales débiles o contradictorias: keynote.
  2. Di la elección en una línea antes de construir, por ejemplo "Estilo: devtool (Next.js + Prisma, rutas /docs y /pricing, vendido a desarrolladores)." Luego lee styles/<preset>.md completamente (keynote: styles/keynote.md).

Qué puede cambiar un preset

Solo a través de las variables en tokens.css (:root) más algunas reglas propias:

  • fuentes (display, cuerpo, mono) y la escala tipográfica, pesos, tracking, interlineado;
  • estilo de ceja e intro, tamaño del cuerpo (nunca por debajo de 14px para UI, 16px para texto de lectura);
  • colores de superficie y texto, luz/oscuro predeterminado, el único acento y el texto sobre él, color de enlace y foco;
  • radios, bordes, sombras, relleno de mosaico; altura del botón, padding, peso, mayúsculas/minúsculas;
  • altura de navegación, relleno y desenfoque; anchos de contenido, espaciado de secciones y mosaicos;
  • easing, duraciones, distancia de revelado, retroalimentación de hover y presión;
  • estilo de imágenes y copy (en su archivo md).

Todo lo que está debajo de esta línea se aplica a todos los presets.

Flujo de trabajo

  1. Respeta el proyecto. Carga tokens.css + styles/<preset>.css, o fusiona el tema de Tailwind, o agrega la paleta de SwiftUI. Un preset puede enlazar las fuentes gratuitas que nombra su archivo md; la página aún debe verse bien con la pila de respaldo. Nunca agregues una dependencia npm para el estilo.
  2. Escribe el plan de la página en 3 líneas: la única cosa que vende la página, el orden de las secciones con fondos, y el único "momento" (un capítulo invertido, un bento de estadísticas grande, una demo, un video, desplazamiento fijo).
  3. Escribe el copy primero: titular corto (el preset establece la longitud), una línea de subtítulo, introducción de máximo dos líneas.
  4. Construye a partir de las recetas, sección por sección.
  5. Verifica en cada ancho de prueba (Responsive), claro y oscuro donde el preset tenga ambos: captura de pantalla, verificación de desbordamiento, lista de verificación. Corrige antes de reportar como terminado.

Reglas principales

Tipografía

  • Una familia para UI (más mono solo para código real, teclas y valores de API). El peso display proviene del preset.
  • El tracking se ajusta a medida que el tamaño crece; el cuerpo nunca tiene tracking negativo más allá de -0.022em.
  • Los tamaños display son fluidos clamp(min, rem + vw, max); siempre mezcla rem en el término medio.
  • Cuerpo 16-17px para lectura; 14px solo en UI densa, líneas meta y pies de página. Altura de línea 1.45-1.6 para el cuerpo.
  • text-wrap: balance en titulares; las palabras largas se ajustan (overflow-wrap, hyphens).
  • Los números importantes son grandes y usan numerales tabulares; sus etiquetas son pequeñas.

Color

  • Colores de marca primero. Un color de marca del usuario o del proyecto reemplaza el acento del preset, que es solo el respaldo. El preset aún decide diseño, tipo, radios, densidad, imágenes y movimiento.
  • Receta de acento (color de marca o cualquier cambio de acento), establecido una vez en :root:
    • --a-blue: el relleno, es decir, el color de marca tal como se da (el nombre antiguo se mantiene; significa "acento").
    • --a-on-accent: tinta o blanco, cualquiera que alcance 4.5:1 sobre el relleno.
    • --a-blue-hover: un paso más oscuro (más claro en un fondo oscuro predeterminado) cuya etiqueta aún pase.
    • --a-accent-text: light-dark(a, b), el tono de la marca desplazado en luminosidad hasta que alcance 4.5:1 sobre --a-bg y --a-bg-alt en cada tema. Los enlaces, las cejas de acento y el anillo de foco (>= 3:1) lo leen. Los presets con un botón primario de tinta (lab, journey) mantienen la tinta en --a-button-*; la marca aún va aquí.
  • Un acento, alcance pequeño: CTA principal, foco, enlaces, una marca de logotipo, badges pequeños y marcadores "recomendado". No superficies grandes o texto del cuerpo a menos que el preset lo diga. Colores de estado solo para estado.
  • Superficies neutras en 2-4 pasos; separación por tono, línea fina o un nivel de sombra suave, según lo que diga el preset.
  • El texto nunca es negro puro sobre blanco; el gris del cuerpo es un gris real con contraste AA.
  • AA en todas partes: 4.5:1 para texto y para etiquetas de botones sobre su relleno, 3:1 para texto grande, iconos y bordes que transmiten significado.
  • El modo oscuro es una paleta diferente, no una invertida: un tono más claro para superficies elevadas, sin sombras para profundidad.

Diseño y ritmo

  • El contenido tiene límites: una columna de texto (--a-content) dentro de una cuadrícula ancha (--a-content-wide), canaletas fluidas.
  • Las secciones alternan color de página y color alternativo; los mosaicos toman el relleno opuesto al de su sección.
  • Héroes centrados y abridores de sección cuando el preset lo dice; el texto dentro de mosaicos y copias largas está alineado a la izquierda.
  • Un momento por página; como máximo un capítulo invertido (oscuro o claro) a menos que el preset esté construido sobre bandas.

Responsive (regla estricta: cada resolución, cada preset)

  • Tipografía y espaciado fluidos a partir de los tokens clamp; valor pequeño a 375px, grande a 1440px.
  • Sin anchos o altos fijos que puedan romperse: max-width + canaleta, min(), minmax(0, 1fr), aspect-ratio, min-height. Nunca 100vh (usa svh/dvh). Los hijos de flex/grid que contienen texto obtienen min-width: 0.
  • Las cuadrículas se reordenan por espacio: repeat(auto-fit, minmax(min(100%, 20rem), 1fr)), no puntos de interrupción de dispositivo.
  • Escalado de medios: max-width: 100%; height: auto; los SVG mantienen un viewBox.
  • Navegación: por debajo de 834px (o tan pronto como 6+ enlaces dejen de caber: consulta de contenedor) los enlaces de texto se mueven a un menú de pantalla completa (popover nativo, sin JS); oculta sus <li> con una regla que supera los estilos de enlace base (recetas: Navegación global). Mantén la marca, la búsqueda y una acción visibles. Sin enlaces de texto (solo búsqueda, cuenta, carrito): sin hamburguesa.
  • Sin barra de desplazamiento horizontal en ningún ancho; solo los desplazadores deliberados (galerías, raíles, código) se desbordan, dentro de su propio cuadro.
  • Objetos táctiles >= 44x44px: píldoras pequeñas, muestras, paletas, enlaces de navegación obtienen un área de impacto invisible (.a-hit).
  • Áreas seguras: viewport-fit=cover; las canaletas y el padding inferior usan env(safe-area-inset-*).
  • Pantallas muy grandes: el tipo y el contenido se detienen en sus límites; los fondos permanecen a sangre completa.
  • Landscape en teléfono: el héroe no debe necesitar la altura del viewport; nada fijo cubre más de un tercio.
  • Zoom 200%: equivale a un viewport de la mitad de ancho; todo se reorganiza, nada recortado.

Anchos de prueba antes de decir terminado (panel del navegador: resize_window a cada uno, captura de pantalla, más document.documentElement.scrollWidth === innerWidth y una lista de elementos más anchos que el viewport):

AnchoRepresenta
320Teléfonos pequeños, zoom 200% de 640
375 / 414Teléfono estándar / grande
768 / 1024Tablet vertical / horizontal, laptop pequeño
1280 / 1440Laptop / escritorio (ancho de referencia)
1920 / 2560Full HD / QHD, ultraancho
812x375Teléfono horizontal
6401280px con zoom 200%

Reporta por ancho: captura de pantalla tomada, desbordamiento sí/no, qué se corrigió. Chrome sin cabeza limita las ventanas por debajo de 500px; prueba los anchos de teléfono en el panel del navegador o con test-widths.html?src=<url de la página> (misma raíz http). Capturas sin cabeza: fuerza el tema con data-theme="light|dark" en <html>; el contenido revelado es invisible en capturas estáticas, así que pasa --virtual-time-budget=5000 o establece data-reveal="off" en <html>; un héroe de 100svh se estira en una ventana de página completa alta, así que fíjalo (min-height: 800px) para la captura (&full=1 hace ambas).

Componentes

  • Botones: altura mínima 44px (los visuales más pequeños obtienen el área de impacto), mayúscula/minúscula de oración a menos que el preset diga mayúsculas, sin iconos excepto un cheurón o flecha final, sin degradados. Primario relleno, secundario según preset.
  • Enlaces: visiblemente enlaces (color o subrayado); cheurones de estilo "Más información ›" donde los usa el preset.
  • Mosaicos/tarjetas: una parada de tabulación cuando todo el mosaico enlaza (el botón interno es un span). Radio, relleno, borde y sombra del preset; nunca todo de relleno + borde + sombra a la vez.
  • Anillo de foco: 2px sólido --a-focus, desplazamiento 1px, en cada elemento interactivo.
  • Nav: sólido o glass según el preset, como máximo una barra fija, página actual marcada.
  • Pie de página: tranquilo: enlaces grises pequeños en columnas, fila legal; las columnas se convierten en acordeones <details> en teléfonos.

Imágenes

  • Asunto real: el producto, su UI, las propias fotos y medios del usuario. Grandes, recortadas con intención.
  • Sin fotos de stock de personas en laptops, sin blobs 3D, sin emojis, sin mascotas, sin icono delante de cada encabezado.
  • Sin activos: dibuja el asunto una vez como un <symbol> SVG recoloreado por variables CSS, o un placeholder gris honesto en la proporción correcta.

Movimiento

  • Transición nombrada pr

… [truncado para traducción]

Skills relacionados