Communitygithub.com

extractor-de-estilos-frontend

Habilidad de diseño. Extrae y documenta un sistema de diseño frontend portátil a partir de una aplicación web existente o un sitio web accesible. Úsalo cuando se te pida analizar estilos de UI, tokens de diseño, tipografía, diseños, componentes, interacciones, capacidad de respuesta o generar reglas de estilo reutilizables para otros proyectos. No rediseña, modifica ni migra la aplicación fuente.

¿Qué es extractor-de-estilos-frontend?

Esta habilidad permite a un agente de IA analizar una aplicación frontend existente o un sitio web accesible y extraer un sistema de diseño portátil y neutral en cuanto a framework, documentado como un "Paquete de Sistema de Diseño Portátil v1.0.0". El propósito no es copiar el código fuente ni crear un clon pixel-perfect, sino generar un contrato de entrega que describe el lenguaje de diseño observado (tokens, reglas de tipografía, layout, componentes e interacciones) para que otra habilidad (`frontend-style-adapter`) lo pueda aplicar en un nuevo proyecto. El flujo de trabajo incluye pasos como orientarse en el repositorio sin modificarlo, ejecutar un inventario heurístico opcional, inspeccionar muestras representativas de la UI (incluyendo estados hover/focus/disabled, modos claro/oscuro y diferentes breakpoints), resolver la jerarquía de reglas (configuración explícita > componentes compartidos > patrones repetidos > excepciones), registrar la procedencia de cada observación con evidencia concreta (archivo + línea, estilo computado o captura de pantalla), generar un conjunto de archivos estructurados (`manifest.json`, `tokens.json`, `rules.json`, etc.) y validar el bundle con un script. La habilidad impone restricciones estrictas: no modificar la aplicación fuente, no copiar datos sensibles (como .env o credenciales) ni activos con licencia, preservar temas separados, no inventar valores de estilo y preferir claridad y patrones de alto valor sobre un volumen masivo de tokens no respaldados. Está pensada para plataformas como Claude Code, Cursor o Codex, donde el agente tiene acceso al sistema de archivos, puede ejecutar scripts de Python y leer archivos de referencia.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MaduroLabs/styleport/tree/HEAD/skills/frontend-style-extractor

Preguntar en tu IA favorita

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

Documentación

Extractor de Estilos Frontend

Objetivo

Producir un Paquete de Sistema de Diseño Portátil v1.0.0 respaldado por evidencia y neutral en cuanto al framework, a partir de un frontend fuente. La salida es un contrato de entrega para frontend-style-adapter, NO código fuente copiado y NO un clon pixel-perfect.

Lee references/CONTRACT.md antes de escribir el paquete. Lee references/INSPECTION_CHECKLIST.md durante la inspección. No inventes valores de estilo ni representes patrones inferidos como hechos observados.

Entradas

  • Fuente: raíz del repositorio / espacio de trabajo, directorios seleccionados o un sitio web renderizado accesible.
  • Opcional: páginas/componentes específicos, temas, puntos de quiebre, fidelidad de diseño, ruta de salida.
  • Valores predeterminados: fuente = repositorio actual; alcance = UI compartida representativa + rutas/páginas descubribles en el repositorio; salida = design-system/portable/ dentro del repositorio fuente (a menos que el usuario solicite otra ubicación).
  • Una URL pública sin CSS fuente accesible ni estilos computados es una fuente solo visual. Marca las mediciones exactas de píxeles/colores/espaciado como inferidas a menos que sean medibles mediante herramientas. Si el entorno no puede abrir el sitio web, explica la limitación en lugar de inventar un análisis.

Flujo de trabajo

  1. Orientarse sin modificar la fuente. Verifica el estado de git, la estructura del proyecto, el manifiesto del paquete, el framework y la pila de estilos, la estructura de rutas/páginas, los estilos globales, los proveedores de temas, las bibliotecas de componentes y los tokens de diseño. Respeta AGENTS.md y las instrucciones del repositorio. Nunca leas .env, secretos ni datos irrelevantes.
  2. Ejecutar el inventario heurístico opcional (solo stdlib; no es un analizador CSS autorizado): python3 <skill-root>/scripts/style_inventory.py <source-root> --out <temporary-path>/style-inventory.json Usa una ruta temporal fuera del repositorio si es posible. Lee el resumen; verifica las afirmaciones importantes directamente en el código/UI renderizada.
  3. Muestrear la UI representativa: caparazón global, navegación, encabezados/texto, botones, campos/formularios, tarjetas, tablas, modales, alertas, estados de carga/vacío/error; inspecciona escritorio y móvil, hover/focus/disabled, claro/oscuro si es compatible. Muestrea rutas comunes e inusuales. Registra las superficies inspeccionadas y omitidas.
  4. Resolver la jerarquía de reglas: tokens/configuración explícita → componentes compartidos → patrones de página repetidos → excepciones únicas. No confundas el diseño de una sola página con una regla global. Conserva tokens semánticos y alias (por ejemplo, var(--brand-primary)) cuando sean significativos; indica los valores reales resueltos solo si están verificados.
  5. Registrar la procedencia: cada token y cada regla estructurada necesita origin, confidence y evidence concreta. Prefiere ruta de archivo + línea/símbolo, observación de estilo computado o referencia de captura de pantalla/viewport. Cada inferencia no respaldada debe etiquetarse como tal. Indica cualquier limitación, páginas no inspeccionadas, incertidumbre sobre licencias de dependencias/activos.
  6. Redactar el paquete en la ruta de salida elegida. Archivos requeridos: manifest.json, tokens.json, rules.json, README.md, typography.md, layout-rules.md, component-rules.md, interaction-rules.md, responsive-rules.md. Opcional assets.md para consideraciones de iconos/imágenes/fuentes. Consulta references/CONTRACT.md y assets/example-bundle/ para la estructura; reemplaza TODO el contenido de ejemplo con observaciones específicas de la fuente. Usa lenguaje portátil (contratos de componentes e intención de diseño) en lugar de una implementación específica del framework como única descripción.
  7. Validar: python3 <skill-root>/scripts/validate_bundle.py <bundle-path>. Corrige todos los errores. Inspecciona manualmente los elementos de baja confianza o desconocidos. No afirmes que se probó la fidelidad visual si no se realizó una comparación de navegador/captura de pantalla.
  8. Informar: fuente y superficies inspeccionadas, método de framework/estilo, ruta de salida, recuentos de tokens/reglas, cobertura/incertidumbres, resultado del validador y uso de entrega: invoca frontend-style-adapter con la ruta del sistema de diseño.

Restricciones estrictas

  • Extraer lenguaje de diseño, no lógica de negocio, copia, activos propietarios o detalles internos de implementación.
  • No modificar la fuente de la aplicación, instalar paquetes, reescribir la configuración ni hacer commit automáticamente. Crear el paquete solicitado está permitido.
  • No copiar logotipos, archivos de fuentes, imágenes/iconos con licencia en el paquete a menos que el usuario lo autorice explícitamente y los derechos estén claros; en su lugar, describe su apariencia, referencias originales y advertencias de licencia.
  • No transferir .env, credenciales, datos de usuario, respuestas de API en vivo ni secretos.
  • Conservar temas claro/oscuro separados y reglas responsivas si existen; no aplanarlos en un solo estilo.
  • Los detalles exactos de implementación pertenecen a la evidence/notas; los requisitos deben permanecer portátiles entre frameworks.
  • Preferir claridad a volumen: patrones documentados de alto valor superan a cientos de tokens no respaldados.
  • Si no hay una UI/navegador ejecutable disponible, informa visualVerification: "not_performed" en el manifiesto.

Hecho cuando

El paquete valida; cada hecho exportado es rastreable; las reglas globales están separadas de las excepciones; los estados de accesibilidad/responsividad están cubiertos; y el informe indica las brechas conocidas.

Skills relacionados