Communitygithub.com

curiositech/port-daddy

Crea diseños web únicos con identidad de marca, paletas de colores, tipografía y patrones modernos de UI/UX. Úsalo para desarrollo de identidad de marca, sistemas de diseño visual, composición de layouts y diseño web responsivo. Actívalo con «diseño web», «identidad de marca», «paleta de colores», «diseño UI», «diseño visual», «layout». NO para detalles de tipografía (usa typography-expert), inmersiones profundas en teoría del color (usa color-theory-expert), tokens de sistemas de diseño (usa design-system-creator) o implementación de código sin dirección de diseño.

¿Qué es port-daddy?

Este skill, actuando como un experto en diseño web, crea sistemas visuales distintivos para aplicaciones web. Guía la selección del layout (grids de 12 columnas para contenido pesado, hero-section para marketing, CSS Grid auto-fit para e-commerce, sidebar para dashboards, o grids mixtos para editorial), la estrategia de paleta de colores (azules para B2B, cálidos para consumo, alto contraste para accesibilidad) y la jerarquía visual según el objetivo del usuario (acción inmediata, consumo de contenido o exploración). Detecta y corrige cinco modos de fallo críticos: diseño por comité, decoración sobre función, mobile como añadido, bajo contraste y colapso de arquitectura de información. Incluye ejemplos detallados (rediseño de dashboard SaaS y página de producto e-commerce), puertas de calidad verificables (10 requisitos como contraste WCAG AA 4.5:1, targets táctiles de 44px mínimo, rendimiento en 3G), y un flujo de auditoría mecánica que ejecuta un script Node.js sobre un plan de diseño estructurado (schemas/design-plan.schema.json). También incorpora un guardia de layout que renderiza la página headlessly para detectar colisiones de texto, elementos truncados y scroll horizontal en múltiples anchos y temas. El skill se apoya en referencias específicas para sistemas de layout, color-accesibilidad e integración con herramientas como 21st.dev y Figma MCP, y define límites claros para evitar superposición con skills especializados en tipografía, teoría del color, sistemas de diseño, estilos retro, diseño nativo móvil, accesibilidad avanzada o animación.

Compatible con✓Claude Code✓Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/curiositech/port-daddy/tree/HEAD/skills/web-design-expert

Preguntar en tu IA favorita

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

Documentación

Experto en Diseño Web

Diseñador web experto que crea sistemas visuales distintivos para aplicaciones web.

Puntos de Decisión

Selección del Enfoque de Layout

SI el contenido es intensivo (blog, documentación, plataforma de aprendizaje)
├─ Sistema de 12 columnas
├─ Alta densidad de texto con jerarquía clara
└─ Medianiles consistentes para legibilidad

SI el enfoque es marketing/conversión (SaaS, landing de e-commerce)
├─ Diseño centrado en hero-section
├─ Layouts asimétricos permitidos para impacto dramático
└─ Espacios en blanco grandes para guiar la atención

SI el enfoque es e-commerce/catálogo pesado
├─ CSS Grid auto-fit para productos
├─ Layouts basados en tarjetas
└─ Prominencia de filtros y búsqueda

SI es interfaz de dashboard/app
├─ Barra lateral + contenido principal
├─ Densidad de datos priorizada
└─ Navegación siempre accesible

SI es estilo editorial/revista
├─ Sistemas de grid mixtos
├─ Imágenes grandes con citas destacadas
└─ Variedad visual sobre consistencia

Estrategia de Paleta de Colores

SI la audiencia es B2B/Empresarial
├─ Azul como primario (confianza, profesionalismo)
├─ Paleta de neutros predominante
└─ Colores de acento mínimos

SI la marca es de Consumo/Estilo de Vida
├─ Primarios más cálidos (naranja, verde, morado)
├─ Opciones de acento estacionales
└─ Elecciones basadas en emociones

SI es crítico para alto tráfico/accesibilidad
├─ Contraste mínimo 4.5:1 obligatorio
├─ Combinaciones probadas para daltonismo
└─ Variantes de modo oscuro requeridas

Árbol de Decisión de Jerarquía Visual

SI el objetivo del usuario = acción inmediata (registro, compra)
├─ CTA del hero arriba del pliegue (obligatorio)
├─ Una sola acción primaria por página
└─ Peso visual en elementos de conversión

SI el objetivo del usuario = consumo de contenido
├─ Vista previa/resumen del contenido primero
├─ Múltiples rutas de interacción aceptables
└─ Experiencia de lectura optimizada

SI el objetivo del usuario = exploración (portafolio, catálogo)
├─ Layout de grid/galería como principal
├─ Optimizado para escaneo rápido
└─ Flujo miniatura → detalle

Modos de Falla

Síndrome de Diseño por Comité

  • Síntomas: Múltiples estilos visuales en la misma página, mensajes de marca contradictorios, sin sistema de diseño claro
  • Regla de Detección: Si ves 3+ estilos de botón diferentes o familias tipográficas en una página
  • Solución: Establece un documento de principios de diseño, impón una única fuente de verdad, obtén la aprobación de los interesados sobre las restricciones

Decoración sobre Función

  • Síntomas: Animaciones sin propósito, elementos visuales que no ayudan a la comprensión, carga lenta debido a gráficos
  • Regla de Detección: Si no puedes explicar cómo cada elemento visual ayuda al usuario a lograr su objetivo
  • Solución: Elimina elementos que no sirvan a las necesidades del usuario, justifica cada animación con un beneficio para el usuario

Patrón de Mobile como Añadido

  • Síntomas: Scroll horizontal en móvil, objetivos táctiles diminutos, navegación de escritorio en pantallas pequeñas
  • Regla de Detección: Si la versión móvil requiere zoom o scroll horizontal para usarse
  • Solución: Empieza con mobile-first, prueba en dispositivos reales, asegura objetivos táctiles mínimos de 44px

Falla de Accesibilidad por Bajo Contraste

  • Síntomas: Texto gris claro (#999) sobre blanco, mala legibilidad bajo luz solar, quejas de usuarios sobre visibilidad del texto
  • Regla de Detección: Si algún texto falla la relación de contraste WCAG 4.5:1 al ser probado
  • Solución: Usa herramientas de verificación de contraste, prueba en condiciones de luz brillante, proporciona una opción de modo de alto contraste

Colapso de Arquitectura de Información

  • Síntomas: Los usuarios no encuentran el contenido principal, la navegación no coincide con los modelos mentales, altas tasas de rebote
  • Regla de Detección: Si los usuarios no pueden completar la tarea principal en 3 clics o 30 segundos
  • Solución: Mapeo del viaje del usuario, card sorting para la navegación, prominencia para acciones clave

Ejemplos Prácticos

Ejemplo 1: Rediseño de Dashboard SaaS

Contexto: Plataforma de análisis B2B, usuarios pasan 2+ horas diarias en la interfaz

Proceso de Decisión:

  1. Análisis de Audiencia: Usuarios avanzados que valoran la eficiencia sobre la estética
  2. Elección de Layout: Navegación de barra lateral (siempre accesible) + área de contenido principal
  3. Estrategia de Color: Azul primario (#2563eb) para confianza, acentos mínimos para reducir carga cognitiva
  4. Jerarquía: Las tablas de datos obtienen más espacio, las acciones son secundarias pero accesibles

Decisiones Clave de Diseño:

  • Visualización densa de información (escala de espaciado de 8px)
  • Texto de alto contraste (#1f2937 sobre #ffffff)
  • Tamaño consistente de botones (altura de 40px para clic fácil)
  • Indicadores de estado con colores semánticos (verde=bueno, rojo=alerta)

Validación de Resultados:

  • Finalización de tareas mejoró un 23%
  • «Facilidad de uso» reportada por usuarios aumentó
  • Tickets de soporte sobre navegación disminuyeron un 40%

Ejemplo 2: Página de Producto de E-commerce

Contexto: Minorista de moda, audiencia mobile-first (70% de tráfico móvil)

Proceso de Decisión:

  1. Patrón de Tráfico: Navegadores móviles, tomadores de decisiones rápidas
  2. Elección de Layout: Una columna en móvil, dos columnas en escritorio
  3. Prioridad Visual: Imágenes de producto > precio > reseñas > especificaciones
  4. Elementos de Conversión: Añadir al carrito fijo en móvil, prominente pero no insistente

Decisiones Clave de Diseño:

  • La imagen principal del producto ocupa todo el ancho de la pantalla en móvil
  • Precio en tipografía grande y negrita, visible de inmediato
  • Resumen de reseñas arriba de los detalles del producto
  • Selectores de talla/color con retroalimentación visual inmediata

Enfoque Novato vs Experto:

  • El novato pondría: Toda la información del producto arriba del pliegue, usaría imágenes pequeñas
  • El experto detecta: Los usuarios necesitan imágenes grandes para evaluar la moda, la audiencia consciente del precio necesita validación temprana con reseñas

Resultados Medibles:

  • Tasa de conversión móvil aumentó un 31%
  • Duración promedio de sesión aumentó (usuarios explorando más productos)
  • Abandono de carrito disminuyó un 18%

Puertas de Calidad

  • La acción principal del usuario es visualmente obvia en menos de 3 segundos desde la carga de la página
  • Todo el texto cumple con los requisitos de contraste WCAG AA (mínimo 4.5:1)
  • El layout móvil funciona en un ancho de 320px sin scroll horizontal
  • Los objetivos táctiles tienen un mínimo de 44px para elementos interactivos
  • Los colores de marca se usan de forma consistente (mismos valores hex en todos los componentes)
  • La jerarquía visual usa un máximo de 3 pesos tipográficos y 4 tamaños
  • La página carga y es interactiva en menos de 3 segundos en conexión 3G
  • La navegación coincide con el modelo mental del usuario (confirmado por tasa de finalización de tareas >80%)
  • El diseño funciona tanto en preferencias de sistema claro como oscuro
  • Los componentes tienen estados definidos para hover, focus y active

Validación de un Plan de Diseño

Indica el cumplimiento de las Puertas de Calidad del diseño como un plan estructurado (consulta schemas/design-plan.schema.json) y verifícalo de forma determinista en lugar de estimar visualmente un mockup:

node scripts/design_audit.mjs --input plan.json

El auditor devuelve { pass, score, findings, recommendations } y marca los cinco modos de falla anteriores por nombre: design-by-committee (demasiados estilos de botón/pesos tipográficos/tamaños), decoration-over-function, mobile-afterthought (scroll horizontal a 320px o targets táctiles sub-44px), low-contrast (por debajo de 4.5:1) y information-architecture collapse (navegación que no coincide con el modelo mental del usuario). Consulta examples/expected-output.md para ver una ejecución exitosa y otra fallida lado a lado.

Referencias

ArchivoCargar Cuando
references/layout-systems.mdNecesites el árbol de decisión de grid, la escala de espaciado de 8px, los breakpoints responsivos, o las listas de verificación mobile-first/consistencia.
references/color-accessibility.mdNecesites la paleta mínima viable, la tabla de psicología del color, la guía de modo oscuro, o la lista de verificación WCAG 2.1 AA.
references/tooling-integration.mdNecesites usar herramientas 21st.dev o Figma MCP para pasar de dirección de diseño a código.
templates/output-template.mdNecesites una plantilla de plan de diseño reutilizable para completar antes de auditar.
examples/expected-output.mdNecesites la forma de una auditoría de plan de diseño terminada, tanto aprobada como fallida.
schemas/design-plan.schema.jsonNecesites validar la estructura de un plan de diseño de forma programática.
scripts/design_audit.mjsNecesites una puntuación determinista de un plan de diseño contra las Puertas de Calidad y los modos de falla nombrados.
agents/openai.yamlNecesites un descriptor de subagente para la generación delegada del plan de diseño.

Límites NO-PARA

NO uses este skill para:

  • Decisiones profundas de tipografía (cálculos de interlineado, espaciado entre caracteres) → usa typography-expert
  • Matemáticas de teoría del color o generación de paletas → usa color-theory-palette-harmony-expert
  • Arquitectura de tokens de sistemas de diseño o variables CSS → usa design-system-creator
  • Estilos de diseño retro o históricos → usa windows-3-1-web-designer
  • Diseño de interfaz de apps nativas móviles → delega en native-app-designer
  • Auditorías detalladas de accesibilidad → usa accessibility-expert
  • Especificaciones de animación y micro-interacciones → usa motion-design-expert

Indicadores de límite:

  • Si el usuario pide recomendaciones específicas de pares tipográficos → typography-expert
  • Si el usuario necesita cálculos de color HSL → color-theory-expert
  • Si el usuario quiere consejos sobre arquitectura CSS → design-system-creator
  • Si el usuario necesita la lista de verificación de cumplimiento WCAG → accessibility-expert

Puerta de QA de Layout (mecánica — ejecutar antes de enviar)

Antes de dar por terminada cualquier página renderizada, artefacto, dashboard, deck o componente, ejecuta el verificador mecánico de desbordamiento/colisión. Renderiza la página headlessly y señala colisiones texto-contra-texto, elementos recortados/truncados con puntos suspensivos, texto que se sale de su contenedor y scroll horizontal de página — los defectos visuales que una captura de pantalla oculta y que solo aparecen a un ancho específico o en un tema.

Resuelve layout-overflow-guard del catálogo de skills activo antes de ejecutarlo. El comando de abajo muestra la ruta de instalación estándar de Claude; usa la ruta reportada por tu sistema. Si el skill está ausente, instálalo o sincronízalo en lugar de saltar esta puerta.

python3 ~/.claude/skills/layout-overflow-guard/scripts/check_layout.py <archivo-o-url> \
  --widths 1280,1100,860,720,390 --themes light,dark

No necesitas leer check_layout.py — invócalo con la herramienta Bash y actúa según su informe y código de salida (distinto de cero = un defecto). El código fuente del script nunca entra en tu contexto; solo sus hallazgos. Llévalo a cero violaciones en todos los anchos y ambos temas antes de enviar. Detalle completo: el skill layout-overflow-guard.

Índice del Bundle del Skill

Cada archivo en este skill y cuándo abrirlo. Generado automáticamente; ejecuta scripts/index_references.py --fix.

raíz

  • CHANGELOG.md — Changelog — Todos los cambios notables en el skill web-design-expert se documentarán en este archivo.
  • README.md — Experto en Diseño Web — Crea sistemas visuales web únicos: identidad de marca, paletas de colores, composición de layouts y patrones de UI responsivos para aplicaciones web.

agents/

examples/

  • examples/expected-output.md — Salida de Ejemplo: Auditoría de Plan de Diseño Web — Escenario: el rediseño de un sitio de marketing SaaS se ha especificado como un plan de diseño estructurado (coincidiendo con schemas/design-plan.schema.json) y está
  • examples/sample-input.json — entrada de ejemplo (datos/esquema)

references/

schemas/

scripts/

templates/

  • templates/output-template.md — Plantilla de Plan de Diseño Web — [Descripción de una oración del producto/página que cubre este plan de diseño.] Notas de campo: - primaryActionObviousWithin3s — verdadero solo si un usuario nuevo

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills relacionados