Communitygithub.com

majiayu000/claude-skill-registry

Pensamiento de diseño y toma de decisiones para interfaces web. Úsalo al diseñar componentes, layouts, esquemas de color, tipografía o al crear interfaces estéticas. Enseña principios, no valores fijos.

¿Qué es claude-skill-registry?

Este skill de agente de IA está diseñado para guiar a asistentes como Claude Code en el proceso de diseño frontend, enfatizando una filosofía de diseño centrada en la psicología del usuario y la toma de decisiones consciente. Su propósito es evitar que la IA caiga en patrones genéricos y 'seguros' (como grids bento, glassmorphism o gradientes mesh), promoviendo en su lugar elecciones radicales y contextuales. El skill obliga al agente a leer siempre un archivo base de psicología UX (`ux-psychology.md`) y a consultar archivos opcionales solo cuando son relevantes para la tarea (color, tipografía, animación, etc.). Incluye una regla crítica de 'Preguntar antes de asumir', forzando al agente a pedir especificaciones al usuario cuando no se definen colores, estilos o layouts. Proporciona guías detalladas sobre leyes de UX (Hick, Fitts, Miller), principios de layout (regla del 60-30-10, rejilla de 8 puntos), escalas tipográficas y efectos visuales. También integra un script de auditoría (`scripts/ux_audit.py`) para evaluar accesibilidad y psicología UX en proyectos existentes. Está diseñado para plataformas como Claude Code, Cursor o Codex, y su formato markdown permite una integración directa en el contexto del agente.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/majiayu000/claude-skill-registry/tree/HEAD/skills/design/frontend-design-themystic07-openwalc

Preguntar en tu IA favorita

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

Documentación

Sistema de Diseño Frontend

Filosofía: Cada píxel tiene un propósito. La moderación es un lujo. La psicología del usuario impulsa las decisiones. Principio fundamental: PIENSA, no memorices. PREGUNTA, no asumas.


🎯 Regla de Lectura Selectiva (OBLIGATORIA)

Lee los archivos REQUERIDOS siempre, los OPCIONALES solo cuando sea necesario:

ArchivoEstadoCuándo Leerlo
ux-psychology.md🔴 REQUERIDO¡Leer siempre primero!
color-system.md⚪ OpcionalDecisiones de color/paleta
typography-system.md⚪ OpcionalSelección/emparejamiento de fuentes
visual-effects.md⚪ OpcionalGlassmorphism, sombras, degradados
animation-guide.md⚪ OpcionalAnimación necesaria
motion-graphics.md⚪ OpcionalLottie, GSAP, 3D
decision-trees.md⚪ OpcionalPlantillas de contexto

🔴 ux-psychology.md = LEER SIEMPRE. Los demás = solo si son relevantes.


🔧 Scripts de Ejecución

Ejecuta estos para auditorías (no los leas, solo ejecútalos):

ScriptPropósitoUso
scripts/ux_audit.pyAuditoría de Psicología UX y Accesibilidadpython scripts/ux_audit.py <ruta_del_proyecto>

⚠️ CRÍTICO: PREGUNTA ANTES DE ASUMIR (OBLIGATORIO)

¡ALTO! Si la solicitud del usuario es abierta, NO recurras a tus favoritos por defecto.

Cuando la Instrucción del Usuario es Vaga, PREGUNTA:

¿Color no especificado? Pregunta:

"¿Qué paleta de colores prefieres? (azul/verde/naranja/neutro/otro?)"

¿Estilo no especificado? Pregunta:

"¿Qué estilo buscas? (minimalista/atrevido/retro/futurista/orgánico?)"

¿Layout no especificado? Pregunta:

"¿Tienes alguna preferencia de layout? (una columna/rejilla/asimétrico/ancho completo?)"

⛔ TENDENCIAS POR DEFECTO A EVITAR (ANTI-PUERTO SEGURO):

Tendencia por Defecto de IAPor Qué es MalaPiensa en su Lugar
Grids Bento (Cliché Moderno)Usado en todo diseño de IA¿Por qué este contenido NECESITA una rejilla?
Hero Split (Izquierda/Derecha)Predecible y aburrido¿Qué tal tipografía masiva o narrativa vertical?
Gradientes Mesh/AuroraEl fondo "nuevo" perezoso¿Cuál es una combinación de colores radical?
GlassmorphismLa idea de IA de "premium"¿Qué tal un diseño plano, sólido y de alto contraste?
Cian Profundo / Azul FintechPuerto seguro tras la prohibición del púrpura¿Por qué no Rojo, Negro o Verde Neón?
"Orquestar / Empoderar"Redacción generada por IA¿Cómo diría esto un humano?
Fondo oscuro + brillo neónSobresado, "aspecto IA"¿Qué necesita REALMENTE la MARCA?
Todo redondeadoGenérico/Seguro¿Dónde puedo usar bordes afilados y brutalistas?

🔴 "Cada estructura 'segura' que elijas te acerca un paso más a una plantilla genérica. TOMA RIESGOS."


1. Análisis de Restricciones (SIEMPRE PRIMERO)

Antes de cualquier trabajo de diseño, RESPONDE ESTO O PREGUNTA AL USUARIO:

RestricciónPreguntaPor Qué es Importante
Cronograma¿Cuánto tiempo hay?Determina la complejidad
Contenido¿Listo o placeholder?Afecta la flexibilidad del layout
Marca¿Guías existentes?Puede dictar colores/fuentes
Tecnología¿Qué stack?Afecta las capacidades
Audiencia¿Quién exactamente?Impulsa todas las decisiones visuales

Audiencia → Enfoque de Diseño

AudienciaPiensa en
Gen ZAtrevido, rápido, mobile-first, auténtico
MillennialsLimpio, minimalista, impulsado por valores
Gen XFamiliar, confiable, claro
BoomersLegible, alto contraste, simple
B2BProfesional, centrado en datos, confianza
LujoElegancia contenida, espacio en blanco

2. Principios de Psicología UX

Leyes Clave (Internalízalas)

LeyPrincipioAplicación
Ley de HickMás opciones = decisiones más lentasLimita opciones, usa revelación progresiva
Ley de FittsMás grande + más cerca = más fácil de hacer clicTamaña los CTA adecuadamente
Ley de Miller~7 elementos en la memoria de trabajoAgrupa el contenido en fragmentos
Von RestorffDiferente = memorableHaz que los CTA sean visualmente distintos
Posición SerialPrimero/último se recuerda másInformación clave al inicio/final

Niveles de Diseño Emocional

VISCERAL (instantáneo)  → Primera impresión: colores, imágenes, sensación general
CONDUCTUAL (uso)        → Al usarlo: velocidad, retroalimentación, eficiencia
REFLEXIVO (memoria)     → Después: "Me gusta lo que esto dice de mí"

Construcción de Confianza

  • Indicadores de seguridad en acciones sensibles
  • Prueba social donde sea relevante
  • Acceso claro a contacto/soporte
  • Diseño consistente y profesional
  • Políticas transparentes

3. Principios de Layout

Proporción Áurea (φ = 1.618)

Úsala para armonía proporcional:
├── Contenido : Barra lateral = aproximadamente 62% : 38%
├── Cada tamaño de encabezado = anterior × 1.618 (para escala dramática)
├── El espaciado puede seguir: sm → md → lg (cada uno × 1.618)

Concepto de Rejilla de 8 Puntos

Todo espaciado y tamaño en múltiplos de 8:
├── Ajustado: 4px (medio paso para micro)
├── Pequeño: 8px
├── Mediano: 16px
├── Grande: 24px, 32px
├── XL: 48px, 64px, 80px
└── Ajusta según la densidad del contenido

Principios Clave de Tamaño

ElementoConsideración
Objetos táctilesTamaño mínimo cómodo para tocar
BotonesAltura basada en jerarquía de importancia
Campos de entradaIgualar altura del botón para alineación
TarjetasRelleno consistente, transpirable
Ancho de lectura45-75 caracteres óptimo

4. Principios de Color

Regla 60-30-10

60% → Primario/Fondo (base tranquila, neutra)
30% → Secundario (áreas de apoyo)
10% → Acento (CTA, destacados, atención)

Psicología del Color (Para la Toma de Decisiones)

Si Necesitas...Considera TonosEvita
Confianza, calmaFamilia azulRojos agresivos
Crecimiento, naturalezaFamilia verdeGrises industriales
Energía, urgenciaNaranja, rojoAzules pasivos
Lujo, creatividadVerde azulado profundo, Oro, EsmeraldaBrillos de aspecto barato
Limpio, minimalistaNeutrosColor abrumador

Proceso de Selección

  1. ¿Cuál es la industria? (reduce opciones)
  2. ¿Cuál es la emoción? (elige el primario)
  3. ¿Modo claro u oscuro? (establece la base)
  4. PREGUNTA AL USUARIO si no está especificado

Para teoría de color detallada: color-system.md


5. Principios de Tipografía

Selección de Escala

Tipo de ContenidoProporción de EscalaSensación
UI densa1.125-1.2Compacto, eficiente
Web general1.25Equilibrado (más común)
Editorial1.333Legible, espacioso
Hero/display1.5-1.618Impacto dramático

Concepto de Emparejamiento

Contraste + Armonía:
├── SUFICIENTEMENTE diferentes para jerarquía
├── SUFICIENTEMENTE similares para cohesión
└── Generalmente: display + neutra, o serif + sans

Reglas de Legibilidad

  • Longitud de línea: 45-75 caracteres óptimo
  • Altura de línea: 1.4-1.6 para texto del cuerpo
  • Contraste: Verifica requisitos WCAG
  • Tamaño: 16px+ para cuerpo en web

Para tipografía detallada: typography-system.md


6. Principios de Efectos Visuales

Glassmorphism (Cuando sea Apropiado)

Propiedades clave:
├── Fondo semitransparente
├── Desenfoque de fondo
├── Borde sutil para definición
└── ⚠️ **ADVERTENCIA:** El glassmorphism azul/blanco estándar es un cliché moderno. Úsalo de forma radical o no lo uses.

Jerarquía de Sombras

Concepto de elevación:
├── Elementos más altos = sombras más grandes
├── Desplazamiento Y > desplazamiento X (luz desde arriba)
├── Múltiples capas = más realista
└── Modo oscuro: puede necesitar brillo en su lugar

Uso de Degradados

Degradados armoniosos:
├── Colores adyacentes en el círculo (análogos)
├── O mismo tono, diferente luminosidad
├── Evita pares complementarios agresivos
├── 🚫 **NO Degradados Mesh/Aurora** (manchas flotantes)
└── VARÍA radicalmente de proyecto a proyecto

Para guía completa de efectos: visual-effects.md


7. Principios de Animación

Concepto de Temporización

Duración basada en:
├── Distancia (más lejos = más largo)
├── Tamaño (más grande = más lento)
├── Importancia (crítico = claro)
└── Contexto (urgente = rápido, lujo = lento)

Selección de Curvas de Aceleración

AcciónCurvaPor Qué
EntradaEase-outDesacelerar, asentarse
SalidaEase-inAcelerar, salir
ÉnfasisEase-in-outSuave, deliberado
JuguetónReboteDivertido, enérgico

Rendimiento

  • Anima solo transform y opacity
  • Respeta la preferencia de movimiento reducido
  • Prueba en dispositivos de gama baja

Para patrones de animación: animation-guide.md, para avanzado: motion-graphics.md


8. Lista de Verificación "Factor WOW"

Indicadores Premium

  • Espacio en blanco generoso (lujo = espacio para respirar)
  • Profundidad y dimensión sutiles
  • Animaciones suaves y con propósito
  • Atención al detalle (alineación, consistencia)
  • Ritmo visual cohesivo
  • Elementos personalizados (no todos por defecto)

Constructores de Confianza

  • Señales de seguridad donde corresponda
  • Prueba social / testimonios
  • Propuesta de valor clara
  • Imágenes profesionales
  • Lenguaje de diseño consistente

Desencadenantes Emocionales

  • Hero que evoca la emoción deseada
  • Elementos humanos (rostros, historias)
  • Indicadores de progreso/logro
  • Momentos de deleite

9. Anti-Patrones (Lo que NO Hacer)

❌ Indicadores de Diseño Perezoso

  • Fuentes predeterminadas del sistema sin consideración
  • Imágenes de stock que no coinciden
  • Espaciado inconsistente
  • Demasiados colores en competencia
  • Muros de texto sin jerarquía
  • Contraste inaccesible

❌ Patrones de Tendencia de IA (¡EVITAR!)

  • Mismos colores en cada proyecto
  • Oscuro + neón como predeterminado
  • Todo púrpura/violeta (PROHIBICIÓN DE PÚRPURA ✅)
  • Grids Bento para páginas de aterrizaje simples
  • Gradientes Mesh y Efectos de Brillo
  • Misma estructura de layout / clon de Vercel
  • No preguntar preferencias del usuario

❌ Patrones Oscuros (No Éticos)

  • Costos ocultos
  • Falsa urgencia
  • Acciones forzadas
  • UI engañosa
  • Confirmshaming

10. Resumen del Proceso de Decisión

Para CADA tarea de diseño:

1. RESTRICCIONES
   └── ¿Cuál es el cronograma, la marca, la tecnología, la audiencia?
   └── Si no está claro → PREGUNTA

2. CONTENIDO
   └── ¿Qué contenido existe?
   └── ¿Cuál es la jerarquía?

3. DIRECCIÓN DE ESTILO
   └── ¿Qué es apropiado para el contexto?
   └── Si no está claro → PREGUNTA (¡no recurras a valores por defecto!)

4. EJECUCIÓN
   └── Aplica los principios anteriores
   └── Verifica contra los anti-patrones

5. REVISIÓN
   └── "¿Esto sirve al usuario?"
   └── "¿Es diferente a mis valores por defecto?"
   └── "¿Estaría orgulloso de esto?"

Archivos de Referencia

Para orientación más profunda en áreas específicas:


Skills Relacionados

SkillCuándo Usarlo
frontend-design (este)Antes de codificar - Aprende principios de diseño (color, tipografía, psicología UX)
web-design-guidelinesDespués de codificar - Audita para accesibilidad, rendimiento y mejores prácticas

Flujo de Trabajo Post-Diseño

Después de implementar tu diseño, ejecuta la auditoría:

1. DISEÑA   → Lee principios de frontend-design ← ESTÁS AQUÍ
2. CODIFICA → Implementa el diseño
3. AUDITA   → Ejecuta revisión de web-design-guidelines
4. CORRIGE  → Aborda los hallazgos de la auditoría

Próximo paso: Después de codificar, usa el skill web-design-guidelines para auditar tu implementación en cuanto a accesibilidad, estados de enfoque, animaciones y problemas de rendimiento.


Recuerda: El diseño es PENSAR, no copiar. Cada proyecto merece una consideración fresca basada en su contexto y usuarios únicos. ¡Evita el Puerto Seguro Moderno SaaS!

Individual skills in this repo

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

majiayu000/claude-skill-registry

Builds, edit or validate Agent Skill through conversational discovery. Use when the user requests to "Create an Agent", "Optimize an Agent" or "Edit an Agent".

majiayu000/claude-skill-registry

Edit existing BMAD agents while maintaining compliance

majiayu000/claude-skill-registry

Edit existing BMAD agents while maintaining compliance

majiayu000/claude-skill-registry

Edit existing BMAD modules while maintaining coherence

majiayu000/claude-skill-registry

Edit existing BMAD modules while maintaining coherence

majiayu000/claude-skill-registry

Analyzes current state and user query to answer BMad questions or recommend the next workflow or agent. Use when user says what should I do next, what do I do now, or asks a question about BMad

majiayu000/claude-skill-registry

Build AI agents with Google ADK Python (Agent Development Kit). Use for multi-agent systems, workflow agents (sequential/parallel/loop), Vertex AI deployment, tool integration, human-in-the-loop.

majiayu000/claude-skill-registry

Build AI agents with Google ADK Python (Agent Development Kit). Use for multi-agent systems, workflow agents (sequential/parallel/loop), Vertex AI deployment, tool integration, human-in-the-loop.

majiayu000/claude-skill-registry

Portfolio allocation and rebalancing optimizer. Manages asset allocation across stocks/cash/bonds, performs periodic rebalancing, and ensures diversification according to market regime and risk tolerance.

majiayu000/claude-skill-registry

Create a hilarious and ultra-realistic video of an anthropomorphic animal acting like a human vlogger in a real-world setting.

majiayu000/claude-skill-registry

Speech-to-text transcription and translation via OpenAI Audio API -- models, response formats, timestamps, prompting, streaming, chunking, and diarization

majiayu000/claude-skill-registry

BlockRun works with Claude Code and Google Antigravity.

majiayu000/claude-skill-registry

This skill should be used when the user asks about libraries, frameworks, API references, or needs code examples. Activates for setup questions, code generation involving libraries, or mentions of specific frameworks like React, Vue, Next.js, Prisma, Supabase, etc.

majiayu000/claude-skill-registry

小省导购员数字人带货版即梦视频提示词生成系统,基于四大智能体协同(提示词生成师、质量管控师、知识库运维师、跨环节适配师),按照"主体+运动+场景+(镜头语言+光影+氛围)"公式输出中英文双版提示词,适配5s短视频。确保人物一致性、视觉连贯性、情绪连贯性,支持知识库智能复用和跨工具适配(Suno音乐、AI绘画),为数字人带货视频提供高质量提示词生成服务。

majiayu000/claude-skill-registry

Upload and manage files using Google Gemini File API via scripts/. Use for uploading images, audio, video, PDFs, and other files for use with Gemini models. Supports file upload, status checking, and file management. Triggers on "upload file", "file API", "upload image", "upload PDF", "upload video", "file management".

majiayu000/claude-skill-registry

CRITICAL: Use for MolyKit AI chat toolkit. Triggers on: BotClient, OpenAI, SSE streaming, AI chat, molykit, PlatformSend, spawn(), ThreadToken, cross-platform async, Chat widget, Messages, PromptInput, Avatar, LLM

majiayu000/claude-skill-registry

AI and machine learning workflow covering LLM application development, RAG implementation, agent architecture, ML pipelines, and AI-powered features.

majiayu000/claude-skill-registry

Analyze images/audio/video with Gemini API (better vision than Claude). Generate images (Imagen 4), videos (Veo 3). Use for vision analysis, transcription, OCR, design extraction, multimodal AI.

majiayu000/claude-skill-registry

Analyze images/audio/video with Gemini API (better vision than Claude). Generate images (Imagen 4), videos (Veo 3). Use for vision analysis, transcription, OCR, design extraction, multimodal AI.

majiayu000/claude-skill-registry

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

Skills relacionados