Communitygithub.com

app-design-studio

Convierte el nombre de una aplicación o la idea de un sitio web/aplicación web en un repositorio completo de diseño UI de alta fidelidad: pantallas, estados, diálogos, componentes e interacciones, con un sistema de diseño fijo y puertas de usabilidad medibles.

¿Qué es app-design-studio?

App Design Studio es una habilidad especializada para asistentes de IA como Claude Code, Cursor o Codex que transforma una idea de aplicación o sitio web en un repositorio de diseño UI completo y de alta fidelidad. Su objetivo principal es generar pantallas o páginas que sean hermosas y usables al mismo tiempo, manteniendo una consistencia perfecta entre todas las vistas. A diferencia de los generadores de imágenes simples, esta habilidad soluciona problemas comunes como la deriva visual entre pantallas, el olvido de estados (carga, vacío, error, sin conexión) y la rotura silenciosa de la usabilidad (texto pequeño, bajo contraste, objetivos táctiles reducidos). Soporta tres objetivos principales con perfiles y vocabulario distintos: aplicaciones móviles (pantallas en modo retrato), sitios web (escritorio en horizontal + diseño responsivo estrecho) y aplicaciones web/portales/dashboard. El flujo de trabajo sigue nueve fases (S0 a S9), desde la ingesta de la idea inicial hasta la revisión final por parte del humano, pasando por la generación de un sistema de diseño (tipografía, colores, espaciado), la creación de un inventario de pantallas, la producción de direcciones de diseño alternativas para que el usuario elija, y finalmente la exportación del repositorio completo con informes de puertas de usabilidad (contraste, objetivos táctiles, tamaño de texto) y componentes. La habilidad también puede auditar y corregir pantallas generadas existentes para mejorar su usabilidad manteniendo su estética. Incluye scripts de Python para linting de prompts, verificación de contraste, ejecución de pruebas de puertas y registro de veredictos, así como una guía completa de referencias para evitar patrones comunes de IA (como gradientes púrpura-azul, tarjetas de vidrio sin motivo, o spamming de gráficos falsos).

Compatible con~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/zohaibmushwani/agent-skills/tree/HEAD/skills/app-design-studio

Preguntar en tu IA favorita

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

Documentación

¿Qué hace app-design-studio?

Objetivo: a partir de un nombre de aplicación, producir un repositorio de diseño que sea hermoso y usable al mismo tiempo, consistente en todas las pantallas y listo para entregar a un diseñador, a un agente que construya Compose/Flutter/React Native, o al puente Compose-to-Figma.

Por qué existe esta habilidad: los modelos de imagen dibujan pantallas individuales atractivas pero se desvían entre pantallas, olvidan estados y rompen silenciosamente la usabilidad (texto pequeño, bajo contraste, objetivos táctiles reducidos). Solución: fijar primero un sistema de diseño, generar a partir de él y luego verificar lo que se puede medir con scripts y lo que no (el gusto) con una rúbrica más una selección humana.

Objetivo = perfil (decidir PRIMERO, en S0; nunca establecer por defecto en silencio cuando el usuario dijo sitio web/portal/dashboard)

ObjetivoOrientación / tamañosLeer estos (y SÓLO estos para la redacción del objetivo)
mobile (app)retrato 9:19.5 pantallas, un tamañoscreen-taxonomy.md, bloques mobile de design-bible-template.md y prompt-templates/README.md, suelos en dp/sp
web tipo site (sitio web, aterrizaje, tienda, blog)horizontal escritorio 16:10 (1440x900) páginas, más un diseño responsivo estrecho de 390px de la misma páginaweb-design.md, prompt-templates/web.md, bloque web de design-bible-template.md, suelos en px
web tipo app (portal, dashboard, admin, SaaS)horizontal escritorio primero; diseño estrecho después. Solo si el usuario dice que los teléfonos son el dispositivo principal, establecer "mobile_first": true y hacer que el diseño estrecho sea el principaligual que site
bothuna biblia y tokens compartidos, dos perfilesambos conjuntos, nunca mezclados dentro de un mismo prompt
Establecer `"platform": "mobile""web"eninventory.json`. Un prompt se escribe exactamente con el vocabulario de un perfil.

Higiene de palabras clave (la razón por la que existe esta sección): los modelos de imagen obedecen las palabras que se les dan. Un prompt de sitio web que diga "retrato", "teléfono", "barra de estado", "9:19.5", "navegación inferior", "zona del pulgar", "Android/iOS" o "pantalla de app" devuelve una pantalla de teléfono. Los prompts web dicen "página web", "escritorio horizontal 16:10, 1440 de ancho", "cabecera con enlaces", "barra lateral", "sin navegador". El diseño estrecho se llama "diseño responsivo estrecho, 390px de ancho", nunca "pantalla de teléfono". python scripts/prompt_lint.py <design-dir> falla cualquier prompt en prompts/ que use palabras de otro perfil; ejecutarlo antes de enviar un lote.

Reglas de salida (siempre)

  • La imagen es la interfaz en sí, de borde a borde: sin marco de dispositivo, sin maqueta de teléfono/portátil, sin marco del navegador, sin fondo extra, sin lienzo alrededor. (Marcos de presentación solo si el usuario pide paneles.) Móvil: pantallas en retrato. Web: páginas de escritorio en horizontal y, donde se indique, el diseño estrecho; páginas largas como una sola imagen alta o 2-3 imágenes de sección del mismo ancho.
  • Los ejemplos en esta habilidad son ilustraciones de un patrón, nunca contenido: no copiar sus nombres, copia, paletas, tipografía o diseños en un prompt (guía contra sesgos en references/design-craft.md).
  • Alta fidelidad: copia real, iconos reales, imágenes reales. Sin lorem ipsum, sin nombres de marca placeholder.
  • Un sistema de diseño en todo el conjunto. Nunca inventar un nuevo estilo por pantalla.
  • Dos modos de prompt (references/design-craft.md): brief (intención corta + los pocos datos que importan + la sensación; por defecto para primeros renders y direcciones S2, da el resultado más distintivo) y locked (cadenas exactas, recuentos, bloque de biblia; para hermanos después de la selección y correcciones). Renderizar brief primero, mirar, luego bloquear lo que debe coincidir. Los modelos fallan mucho más en consistencia que en belleza, pero sobre-constreñir el primer render lo vuelve mecánico.
  • Editar, no regenerar: corregir una cadena incorrecta con un pase de edición nombrando solo ese cambio; una regeneración completa tira todo lo ya aprobado.
  • Sin marcas reales, logotipos o rostros de personas reales; solo nombres ficticios y marcas genéricas. Nunca escribir claves API en el repositorio.
  • Responder al usuario en el idioma en que escribe (a menudo urdu romanizado/hinglish); los archivos y prompts permanecen en inglés.

Flujo de trabajo (S0-S9)

Trabajar en la carpeta del proyecto del usuario bajo design/<app-slug>/ (estructura: references/repo-layout.md). Registrar el estado de la fase en design/<app-slug>/STATUS.md. Preguntar al usuario solo cuando la respuesta cambie el resultado (máx. 3 preguntas en S0); de lo contrario, elegir un valor predeterminado sensato y decirlo.

S0 Toma de requisitos. Nombre de la app/sitio, propósito en una línea, audiencia, objetivo + tipo (tabla anterior; preguntar si aparecen las palabras "sitio web", "portal", "dashboard" o "aterrizaje" y el objetivo no está claro), sensación de plataforma (móvil por defecto: Android + iOS neutro, Material 3 tirando; web: neutro), palabras de tono, claro/oscuro (por defecto: tokens claro + oscuro, pantallas en claro). Escribir BRIEF.md (problema, audiencia, alcance, no objetivos); si el usuario no está disponible, indicar la interpretación que se tomó al principio en lugar de esperar. Leer references/aesthetic-vs-usability.md una vez.

S1 Inventario de pantallas. Construir inventory.json desde references/screen-taxonomy.md (web: references/web-design.md sección 4): núcleo fijo (splash, idioma, onboarding, permisos, autenticación, inicio, ajustes) + pantallas de características específicas de esta app + detalles + estados + diálogos + hojas + componentes. Cada elemento tiene id, grupo, propósito, estados, prioridad. Mostrar al usuario una lista compacta; confirmar antes de gastar créditos de imagen.

S2 Plan de diseño + biblia + 3 direcciones (puerta humana). Primero escribir un plan de diseño de 10 líneas por dirección (references/design-craft.md sección 2) y autoevaluarlo contra los valores predeterminados genéricos. Luego escribir la biblia (references/design-bible-template.md) como tres alternativas cortas (diferente estado de ánimo, lógica de paleta, tipo, lenguaje de formas). Cada biblia nombra el color del texto sobre cada color relleno (sobre-primario, sobre-acento, texto de insignia) y la barra de estado de la plataforma (Android: hora a la izquierda, iconos a la derecha; iOS: estilo 9:41). Antes de renderizar, poner la paleta de cada dirección en un pequeño archivo de tokens y ejecutar scripts/contrast_check.py sobre él: una dirección que solo se vea bien con contraste deficiente no debe llegar a la selección humana. Escribir cada prompt en prompts/<id>.<direction>.md primero y enviar exactamente el texto de ese archivo (el prompt guardado es el reproducible). Renderizar una pantalla principal por dirección (web: la misma página, escritorio y móvil). Enviar las tres en una sola llamada de Codex. Detenerse y dejar que el usuario elija - el gusto es lo único que los scripts no pueden juzgar, así que aquí es donde el humano decide. Registrar la elección en DESIGN.md.

S3 Tokens. Desde la dirección elegida escribir tokens.json (colores claro/oscuro, escala tipográfica, espaciado cuadrícula 4/8, radio, elevación, tamaño de icono, objetivo táctil). Ejecutar scripts/contrast_check.py tokens.json y corregir los pares que fallen ahora - más barato que corregir 40 pantallas después.

S4 Panel de componentes. Generar la hoja de componentes (botones, campos de entrada, chips, tarjetas, filas de lista, navegación, barra superior, toasts, diálogos, hojas) a partir de los tokens. Esta imagen es la referencia visual pasada a cada generación posterior, lo que mantiene las pantallas consistentes.

S5 Pantallas. Generar pantallas en orden de inventario usando references/prompt-templates/. Cada prompt comienza con el bloque de biblia bloqueado, luego cadenas y recuentos exactos, luego una lista explícita "no añadir". Elegir el motor según el trabajo: un modelo con capacidad de texto (gpt-image/Codex, Nano Banana, Stitch) para pantallas completas, o la ruta de renderizado HTML (texto y recuentos exactos, luego captura de pantalla; probado de extremo a extremo en un conjunto de 21 pantallas de lector de PDF: escribir html/<group>/<id>.html desde variables CSS de tokens.json e iconos Iconify, luego node scripts/render_screens.mjs <design-dir> escribe el PNG más un <id>.spec.json medido desde el DOM real, y run_gates.py lo audita; necesita Node + playwright, env PLAYWRIGHT_MODULE/CHROME_PATH si no está instalado localmente) - FLUX/Runware distorsiona el texto y los recuentos de la interfaz, así que usarlo solo para arte que va dentro de una pantalla. Usar Iconify MCP para los iconos para que el estilo de icono siga siendo una familia. Pasar el panel de componentes como referencia de estilo cuando la herramienta lo permita. Guardar como screens/<group>/<id>.png más <id>.spec.json (elementos con tamaño, tamaño de fuente, colores, indicador interactivo - esquema en references/repo-layout.md).

S6 Estados, diálogos, hojas. Mismos prompts, misma biblia. Los estados vacíos guían la siguiente acción; el error es visualmente diferente de vacío; la carga utiliza esqueletos que coinciden con el diseño real.

S7 Autocrítica, veredictos y registro de prompts. Criticar cada renderización uno mismo antes de mostrarla (references/critique-template.md: aprobado/fallido de usabilidad con evidencia + rúbrica estética, escrito en reports/critique/<id>.md); por debajo de 4.0 o cualquier FALLO de usabilidad significa corregir mediante pase de edición o rechazar y regenerar, sin esperar al usuario. Después de mirar CADA imagen generada escribir un veredicto (aceptar / corregir / rechazar) y registrarlo: python scripts/prompt_log.py add <design-dir> --id ... --image ... --prompt ... --mode brief|locked|edit --verdict ... --tags ... --reason ...; las imágenes rechazadas se mueven a rejected/. prompt_log.py summary muestra la tasa de aceptación por modo de prompt y las etiquetas de fallo recurrentes; cualquier etiqueta rechazada dos veces se convierte en una línea en references/design-craft.md "Lecciones aprendidas" (así es como la habilidad mejora). Luego ejecutar python scripts/run_gates.py design/<app-slug>. Ejecuta contraste, lint de tokens, auditoría de elementos (objetivos táctiles, tamaño de texto mínimo) y cobertura de estados, y escribe reports/gates.md. Luego puntuar cada pantalla con la rúbrica en references/aesthetic-vs-usability.md (abrir el PNG y mirar - no puntuar de memoria). Regenerar las pantallas que fallen, máximo 2 intentos cada una; si siguen fallando, marcarlo para el usuario en lugar de repetir.

S8 Exportación. Ensamblar el repositorio (references/repo-layout.md): PNGs, especificaciones, tokens, DESIGN.md, inventario, mapa de flujo, copy/strings.json, informes. Extras opcionales, solo cuando el usuario los quiera: (a) capa de verdad HTML para valores CSS exactos (references/image-qa-loop.md), (b) almacenar activos - icono, gráfico de características, capturas de pantalla de la tienda con titulares renderizados como texto HTML, validados por scripts/validate_assets.py contra references/store-asset-specs.md. Para capturas de pantalla de marketing de la tienda (conjuntos liderados por titulares como aplicaciones de los primeros puestos) usar la habilidad store-screenshots con estas pantallas como entrada. Entrega opcional: tokens/especificaciones alimentan el código Compose + puente Figma; decirlo en HANDOFF.md.

S9 Revisión humana. Presentar la hoja de contactos y el informe de puertas. Cualquier cosa generada antes de que exista la aplicación real se etiqueta como concept (nunca presentar gráficos de tienda conceptuales como capturas reales).

Guía de juicio (estética vs usabilidad)

Los suelos dependen del objetivo: móvil = números dp/sp a continuación; web = suelos px en references/web-design.md sección 3 (área de impacto de 44px, cuerpo >= 16px, líneas de 65 caracteres, sin desplazamiento horizontal a 390). Tratar la usabilidad como un suelo y la estética como el techo. Los números de suelo no son negociables porque son medibles: objetivos táctiles >= 48dp (44pt iOS), texto del cuerpo >= 16sp y nada por debajo de 12sp, contraste 4.5:1 (3:1 para texto grande e iconos), una acción principal por pantalla, acciones clave en la zona inferior del pulgar, cuadrícula de espaciado 4/8. Por encima del suelo, gastar personalidad: un emparejamiento tipográfico distintivo, un acento controlado, un momento memorable de ilustración o imagen por flujo, espaciado generoso. Cuando entren en conflicto (por ejemplo, una etiqueta elegante gris pálido), la usabilidad gana y se recupera la elegancia en otro lugar (peso, espaciado, contraste de tamaño), no bajando el suelo.

Evitar ("marcas de IA")

Leer references/design-craft.md, references/interaction-and-density.md y references/ai-tells-avoid.md antes de escribir el primer prompt (los breves indican el objetivo de densidad: pocas palabras, espacio generoso, una acción principal). La versión corta: degradados púrpura-azul, tarjetas de vidrio sin motivo, anidación caja-en-caja, spam de gráficos falsos, pantallas de inicio con doce widgets, mezclas genéricas de paquetes de iconos, pequeñas etiquetas decorativas, lorem ipsum, pantallas clonadas con pequeñas ediciones.

Mapa de referencias

  • references/screen-taxonomy.md - qué pantallas/estados/diálogos/hojas existen y cuándo (solo objetivo MÓVIL).
  • references/web-design.md - objetivo sitio web / aplicación web: viewports, suelos px, taxonomía de páginas, diseño, marcas de IA web.
  • references/prompt-templates/web.md - bloques de FORMATO/CONTENIDO web y prompts por tipo de página.
  • references/aesthetic-vs-usability.md - diales, suelos, rúbrica, reglas de regeneración.
  • references/design-bible-template.md - el bloque repetido en cada prompt.
  • references/prompt-templates/ - prompts por tipo de pantalla.
  • references/design-craft.md - prompts breves vs bloqueados, plan de diseño, valores predeterminados genéricos, audacia en un solo lugar, reglas de copia, bucle de crítica.
  • references/ai-tells-avoid.md - antipatrones.
  • references/repo-layout.md - estructura de carpetas y esquemas JSON.
  • references/image-qa-loop.md - el bucle de verificación/edición por imagen, capa de verdad HTML opcional, strings.json.
  • references/store-asset-specs.md - tamaños y reglas de Play/App Store (revisar páginas oficiales antes de enviar).
  • references/interaction-and-density.md - presupuesto de palabras/densidad, revelación progresiva, estado de interacción visible, preguntas de revisión (usar en cada breve y crítica).
  • references/critique-template.md - el bucle de autocrítica y corrección por imagen.
  • scripts/prompt_log.py - registro de veredictos + resumen de aprendizajes (ver S7).
  • assets/ - ejemplo de tokens.json, inventory.json, spec.json, esqueleto de DESIGN.md.
  • scripts/ - puertas deterministas (Python): contrast_check.py, run_gates.py, render_screens.mjs, prompt_lint.py, validate_assets.py, prompt_log.py.
  • templates/ - screen.html.mustache, spec.json.mustache.
  • ai-tells-avoid.md - patrones de interfaz que delatan a la IA (guardar como referencia).

Nota del traductor

El texto de los archivos, prompts y código permanece en inglés tal como se especifica en las reglas. La documentación traducida aquí es para que el usuario humano entienda la habilidad en su idioma.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

screenshot-to-compose

Turn app design screenshots (JPG/PNG, often AI-generated) or Figma frames into a native Kotlin Jetpack Compose UI that matches them, design-first. Measures pixels and colours (px to dp), writes screen/asset inventories and a design system with observed vs inferred values, builds Iconify icons into VectorDrawables, generates artwork instead of cropping the screenshots, implements MVI screens, then compares emulator or Roborazzi renders against the reference. Use whenever the user supplies screenshots, mockups or a design repository and wants them built as an Android Compose app, says "make this screen in Compose", "match the design", "px to dp", "screenshot to code", or wants a whole app UI built design-first, even if they never say "Compose".

store-screenshots

Create App Store and Google Play marketing screenshot sets that look like top-chart apps - a headline-led story of 5-8 frames with a poster-style first frame, zoomed real UI fragments, a dominant brand colour, panoramic links between frames, social proof and human touches - generated frame by frame with Codex (GPT Image) using the app's real screens as reference images, text-checked and edit-passed, then fitted to the exact store sizes. Use whenever the user wants store screenshots, "App Store screenshots", "Play Store images", listing graphics, a screenshot redesign or "before/after" for a store page, or wants their app's store page to convert better, even if they only say "screenshots" for an app. Takes real app screens (for example from app-design-studio) as input.

Skills relacionados