Communitygithub.com

wjdgus6480/portfolio

Define los estándares globales de UI/UX y diseño visual para un portafolio personal de desarrollador.

¿Qué es portfolio?

Este skill establece un sistema de diseño completo y detallado para el portafolio de un desarrollador individual, con el objetivo de transmitir una imagen profesional, moderna, minimalista y técnica. Se enfoca en que el contenido y los proyectos sean los protagonistas, evitando decoraciones excesivas o genéricas. Define principios clave como el uso prioritario de un modo claro (Light Mode) con una paleta de colores neutros y un acento azul limitado, tipografía legible para coreano (Pretendard), y un sistema de rejilla de 2 columnas para proyectos. Además, incluye pautas para componentes específicos como el encabezado, la sección Hero, las tarjetas de proyecto (con estado, problema, solución y tecnologías), la sección de habilidades (sin valores numéricos arbitrarios), y la separación estricta entre contenido y UI. El skill también aborda la accesibilidad, el diseño responsive, las animaciones funcionales, el flujo de trabajo de implementación en 7 pasos, y reglas no negociables sobre la integridad de los datos (prohibiendo inventar proyectos o logros) y la preservación de la funcionalidad existente.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/wjdgus6480/portfolio/tree/HEAD/claude/skills/design-theme

Preguntar en tu IA favorita

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

Documentación

Skill de Tema de Diseño

1. Identidad del Skill

  • Nombre: design-theme
  • Propósito: Define los estándares globales de UI/UX y diseño visual para un portafolio personal de desarrollador.
  • Destinatario: Portafolio de Desarrollador de IA / Software / Producto
  • Objetivo Principal: Transmitir la impresión de un desarrollador que descubre problemas reales y utiliza la IA y el software para crear productos, en lugar de un simple listado de tecnologías.

2. Filosofía de Diseño Central

Este portafolio prioriza las siguientes impresiones:

  • Profesional
  • Moderno
  • Mínimo
  • Técnico
  • Orientado a producto
  • Legible
  • Confiable

Principios Clave

"El contenido y los proyectos deben ser los protagonistas, no la decoración."

El usuario debe poder entender rápidamente lo siguiente al ver la primera pantalla:

  1. ¿Quién es?
  2. ¿Qué crea?
  3. ¿Qué problemas resuelve?
  4. ¿Qué proyectos ha creado?
  5. ¿Qué tecnologías utiliza?
  6. ¿Es una persona que realmente puede desarrollar?

3. Dirección Visual

Dirección Base

  • Priorizar el Modo Claro
  • Base blanca limpia / gris claro
  • Acento azul limitado
  • Bordes finos
  • Espacio en blanco generoso
  • Tipografía fuerte
  • Cuadrícula ordenada
  • Decoración excesiva mínima

Direcciones a Evitar

Los siguientes diseños no se utilizan por defecto:

  • Gradientes excesivos
  • Brillo intenso
  • Efecto de vidrio (Glassmorphism)
  • Efectos 3D excesivos
  • Animaciones sin sentido
  • Sombras excesivas
  • Colores arcoíris
  • Demasiadas insignias (Badges)
  • Abuso de ilustraciones decorativas
  • Plantillas genéricas comunes en portafolios de IA
  • Insignias tecnológicas (Tech Badges) que usan colores diferentes para cada tecnología
  • Diseños donde el diseño se ve antes que el contenido

4. Sistema de Color

Base

Background      #FAFAFA
Surface         #FFFFFF
Foreground      #18181B
Text Secondary  #52525B
Text Weak       #71717A
Placeholder     #A1A1AA
Border          #E4E4E7
Background Weak #F4F4F5

Acento

Accent          #2563EB
Accent Hover    #1D4ED8
Accent Soft     #EFF6FF

El acento se utiliza de forma limitada en toda la pantalla.

Ubicaciones del Acento

  • CTA principal
  • Enlaces importantes
  • Navegación activa
  • Estado de enfoque (Focus)
  • Información importante
  • Estados de Proyecto que necesitan énfasis

No se utiliza el acento como fondo de pantalla completa o decoración excesiva.

Estado

Success #16A34A
Warning #D97706
Error   #DC2626

Los colores de estado solo se utilizan para expresar un estado real.


5. Tipografía

Prioridad de Fuentes

Se prioriza la legibilidad del coreano.

Orden recomendado:

Pretendard
system-ui
sans-serif

Para código, nombres técnicos, números e información meta, se puede utilizar:

Geist Mono
monospace

Escala Tipográfica

Hero

Escritorio:

56px ~ 72px
font-weight: 700 ~ 800
line-height: 1.05 ~ 1.15

Móvil:

40px ~ 48px
font-weight: 700 ~ 800
line-height: 1.1 ~ 1.2

H2

Escritorio:

36px ~ 44px

Móvil:

30px ~ 34px

H3

20px ~ 24px

Cuerpo (Body)

16px ~ 18px
line-height: 1.6 ~ 1.75

Pequeño / Meta

13px ~ 14px

6. Sistema de Diseño

Contenedor

Ancho máximo por defecto:

1200px

Relleno Horizontal (Padding)

Escritorio:

32px ~ 48px

Tableta:

24px

Móvil:

20px

Espaciado entre Secciones

Escritorio:

120px ~ 160px

Móvil:

80px ~ 100px

No se aplica el mismo espaciado de manera forzada en toda la página. El espaciado se ajusta según la importancia del contenido.


7. Sistema de Cuadrícula

El área de Proyectos utiliza la siguiente estructura por defecto:

Escritorio

2 Columnas

Tableta

2 Columnas

Móvil

1 Columna

No se utilizan cuadrículas de 3 o más columnas a menos que haya una razón especial. Es más importante que el contenido de las tarjetas de proyecto se lea suficientemente que la cantidad de columnas de la cuadrícula.


8. Encabezado (Header)

El encabezado se compone de la mínima interfaz de navegación para el portafolio.

Estructura recomendada:

Logo / Nombre
Projects
About / Approach
Contact

Se pueden añadir enlaces a Currículum o GitHub si se desea.

Principios del Encabezado

  • Prohibir un encabezado excesivamente grande
  • No alargar la navegación innecesariamente
  • En móvil, reducir a un menú si es necesario
  • Usar el acento de forma limitada para el estado activo

9. Hero

El Hero es el área más importante de la primera pantalla.

El objetivo no es verse llamativo, sino transmitir la identidad del desarrollador de inmediato.

Estructura recomendada:

Subtítulo (Eyebrow)
↓
Encabezado Principal
↓
Descripción Corta
↓
CTA Primario / CTA Secundario

Ejemplo de dirección:

Cuando encuentro un problema,
lo creo yo mismo.

JungHyun Yoon, un desarrollador que resuelve problemas reales y crea productos
utilizando IA y software.

Sin embargo, el texto final real se gestiona en un archivo de contenido separado. No se codifica el contenido dentro del componente Hero.


10. Diseño de Proyectos

Los proyectos son el contenido central del portafolio.

Una tarjeta de proyecto no debe ser simplemente una tarjeta que muestre solo nombres de tecnologías.

En la medida de lo posible, se transmite la siguiente información:

Nombre del Proyecto
Estado
Resumen Breve
Problema
Solución
Tecnología
Período

No se fuerza toda la información en una sola tarjeta. Si hay mucha información, se redirige a una página de detalle.


11. Tarjeta de Proyecto

Estilo base:

Background: #FFFFFF
Border: 1px solid #E4E4E7
Border Radius: 12px ~ 16px
Padding: 24px ~ 32px
Shadow: none o muy suave

Los efectos Hover se minimizan.

Recomendado:

Cambio de border-color
Cambio de background
transform: nivel muy pequeño

No se utilizan efectos de ampliación excesivos o brillo (Glow).


12. Estado del Proyecto

El estado del proyecto se expresa claramente.

Ejemplo:

Live
In Progress
Archived

Al expresar el estado, no se transmite el significado solo con color. Se utiliza texto o iconos juntos.


13. Etiquetas de Tecnología

Las etiquetas de tecnología son elementos auxiliares para identificar información rápidamente.

No se aplican colores arcoíris a cada tecnología. Por defecto, se utiliza un estilo neutral.

Ejemplo:

Next.js
TypeScript
Python
FastAPI
Supabase
SQLite
AI Agent

Las etiquetas de tecnología no deben ser más llamativas que la descripción del proyecto.


14. Página de Detalle del Proyecto

Al hacer clic en una tarjeta de proyecto, se puede utilizar la siguiente estructura:

Encabezado del Proyecto
↓
Descripción General (Overview)
↓
Problema
↓
Enfoque (Approach)
↓
Implementación
↓
Desafíos
↓
Resultado
↓
Lo que Aprendí
↓
Tecnología
↓
Enlaces

No todos los proyectos deben tener todas las secciones. Solo se muestra la información que existe en el proyecto real.


15. Proyectos Destacados (Featured Projects)

En la página de inicio, no se muestran todos los proyectos con el mismo peso. Se seleccionan los proyectos principales según el estado featured.

Ejemplo:

featured: true

La UI muestra los proyectos basándose en el valor featured. Por lo tanto, no debería ser necesario modificar el código del componente para excluir un proyecto de los destacados.


16. Más Proyectos (More Projects)

Debajo de los Proyectos Destacados, se puede proporcionar un área para ver otros proyectos.

Propósito:

No se trata de evitar que el portafolio parezca tener pocos proyectos, sino de mostrar la variedad de problemas que el desarrollador ha resuelto.

Se mantiene la jerarquía visual entre los proyectos destacados y los proyectos normales.


17. Sección de Enfoque (Approach Section)

En lugar de un típico "Acerca de Mí", se considera primero un área que muestre el enfoque de desarrollo.

Ejemplo:

01 Problema
02 Descubrimiento
03 Aprendizaje
04 Construcción
05 Resultado

El mensaje clave es:

Descubrir un problema → investigar → aprender las tecnologías necesarias → crearlo uno mismo → verificar el resultado.

Se prioriza mostrar el proceso de desarrollo real y la forma de pensar, en lugar de una simple autopresentación.


18. Habilidades (Skills)

Las habilidades no son solo una lista de tecnologías, sino que muestran el contexto de uso real.

Clasificación recomendada:

Frontend
Backend
AI / Automation
Database
Tools

Ejemplo:

Frontend
Next.js
React
TypeScript
Tailwind CSS

Backend
Python
FastAPI
Flask

AI / Automation
AI Agent
RAG
LLM API
Automation

Database
SQLite
PostgreSQL
Supabase

Tools
Git
GitHub
VS Code

Sin embargo, no se añaden tecnologías sin experiencia de uso real.


19. Representación de Habilidades

No se expresa el nivel de habilidad con números arbitrarios o estrellas.

Uso prohibido:

Python ★★★★★
React 90%
AI 95%

En su lugar, se conecta con proyectos reales y el propósito de uso.

Ejemplo:

Python
→ Utilizado en proyectos de AI Agent / Automation / Backend

20. Contacto

El área de Contacto se compone de forma simple y clara.

Recomendado:

Mensaje Breve
Correo Electrónico
GitHub
LinkedIn u otros enlaces reales

No se crean contactos o enlaces que no existan realmente.


21. Pie de Página (Footer)

El pie de página se compone al mínimo.

Ejemplo:

© 2026 JungHyun Yoon
Construido con Next.js

No se incluye información más allá de lo necesario.


22. Diseño Responsive

Se deben considerar los siguientes entornos:

Escritorio
Tableta
Móvil

No se implementa el diseño responsive simplemente reduciendo la pantalla. Especialmente en móvil:

  • Cambiar la estructura de navegación
  • Ajustar la tipografía Hero
  • Cambiar la cuadrícula → 1 columna
  • Ajustar el tamaño de los botones
  • Reducir el relleno (padding)
  • Verificar el salto de línea en textos largos
  • Ajustar la prioridad de la información en las tarjetas de proyecto

23. Accesibilidad

Se debe considerar la accesibilidad básica en todo momento.

  • Jerarquía de encabezados adecuada
  • Contraste de color suficiente
  • Enfoque de Teclado (Keyboard Focus)
  • Botones / Enlaces claros
  • Texto Alternativo (Alt Text) en imágenes
  • Se recomienda un área táctil de 44px o más
  • No distinguir estados solo con color
  • Configurar para que la información se pueda transmitir incluso sin animaciones

24. Animación

Las animaciones solo se utilizan cuando ayudan a la funcionalidad.

Recomendado:

150ms ~ 300ms
ease-out

Áreas permitidas:

  • Hover en Botón
  • Hover en Enlace
  • Hover en Tarjeta
  • Navegación
  • Revelación breve de secciones (Section Reveal)

Lo que no se utiliza:

  • Parallax
  • Animaciones de desplazamiento excesivas
  • Movimiento continuo
  • Animaciones decorativas sin sentido
  • Efectos excesivos al entrar en la página

25. Modo Oscuro

En la primera versión actual, se prioriza el Modo Claro. El Modo Oscuro se añadirá cuando haya un requisito separado. No se debe complicar el sistema de diseño actual o la estructura de componentes debido al Modo Oscuro.


26. Reglas Técnicas de Diseño

Se utiliza Tailwind CSS como sistema de estilo base. Las Variables CSS se usan para gestionar tokens de diseño global.

Recomendado:

Tailwind
+
CSS Variables

No se utilizan estilos en línea innecesarios.


27. Reglas de Componentes

Se utiliza React Server Component como valor por defecto. Solo se utilizan Client Component en los siguientes casos:

  • Entrada de usuario
  • Gestión de estado
  • API del navegador
  • Interacciones basadas en eventos
  • Cuando se necesita ejecución en el cliente, como bibliotecas de animación

No se convierte toda la página en un Client Component innecesariamente.


28. Separación de Contenido / UI

Se separa el contenido de la UI.

Estructura recomendada:

content/
├─ profile.ts
├─ projects.ts
├─ skills.ts
└─ types.ts

No se escribe la información del proyecto directamente dentro de los componentes de UI. Al añadir o modificar un proyecto, se diseña para que se refleje en la pantalla modificando solo:

content/projects.ts

29. Principio de Datos del Proyecto

Los datos del proyecto se gestionan en una forma estructurada.

Ejemplo:

{
  slug,
  title,
  summary,
  problem,
  solution,
  tech,
  status,
  featured,
  period,
  image,
  links,
  highlights
}

Solo se utilizan los valores necesarios. No se rellena arbitrariamente información que no existe realmente.


30. Reglas de Imágenes

Si una imagen de proyecto no existe realmente, no se genera ni se obtiene una imagen arbitraria. Si se necesita un marcador de posición (placeholder), se indica claramente que es un marcador de posición. Se crea una estructura para poder reemplazar la imagen del proyecto cuando se obtenga una captura de pantalla real del proyecto.


31. Integridad de los Datos

Es uno de los principios más importantes del portafolio.

Nunca se genera arbitrariamente lo siguiente:

  • Proyectos que no existen
  • Experiencia tecnológica que no existe
  • Logros que no existen
  • Cifras que no existen
  • Clientes que no existen
  • Experiencia laboral que no existe
  • Enlaces que no existen
  • Certificaciones / Calificaciones que no existen
  • Resultados de proyectos que no existen

Si falta información, se prioriza:

Dejarlo vacío

o

Confirmar con el usuario

32. Preservación de Proyectos Existentes

No se altera arbitrariamente el significado de los proyectos existentes. Se trabaja basándose en las descripciones de proyectos o requisitos proporcionados por el usuario. Si es necesario eliminar o reducir una funcionalidad existente, primero se explica el motivo y se solicita confirmación.


33. Arquitectura de la Información del Portafolio

La estructura de inicio por defecto considera primero lo siguiente:

Encabezado
↓
Hero
↓
Proyectos Destacados
↓
Más Proyectos
↓
Enfoque
↓
Habilidades
↓
Contacto
↓
Pie de Página

Sin embargo, se puede ajustar según el contenido real y la usabilidad.


34. Prioridad de Decisiones de Diseño

Cuando surgen conflictos de diseño, se sigue la siguiente prioridad:

1. Legibilidad del contenido
2. Jerarquía de la información
3. Accesibilidad
4. Usabilidad responsive
5. Consistencia
6. Estética visual
7. Efectos decorativos

Se prioriza un diseño fácil de leer y entender, por encima de un diseño bonito.


35. Flujo de Trabajo de Implementación

Al crear una nueva página o UI, se sigue el siguiente orden:

PASO 1. Analizar

Primero, verificar la estructura actual del proyecto y la UI existente.

PASO 2. Planificar

Proponer la estructura de información necesaria y la composición de la pantalla.

PASO 3. Diseñar

Proponer la dirección visual basada en los principios de diseño de este SKILL.md.

PASO 4. Componente

Proponer la estructura de componentes necesaria.

PASO 5. Confirmar

Para cambios estructurales grandes o nuevas funcionalidades, obtener la confirmación del usuario antes de la implementación.

PASO 6. Implementar

Implementar solo el alcance confirmado.

PASO 7. Verificar

Verificar lo siguiente:

TypeScript
Build
Responsive
Accesibilidad
Consistencia visual
Funcionalidad existente

36. Gestión de Cambios

Para modificaciones pequeñas, se mantiene la estructura existente al máximo. Antes de un cambio grande:

  1. Verificar la estructura actual
  2. Explicar el motivo del cambio
  3. Verificar el alcance del impacto
  4. Proponer alternativas
  5. Obtener la aprobación del usuario
  6. Implementar

Seguir este orden.


37. Dependencias

Se añaden nuevas bibliotecas solo cuando la necesidad es clara. Si se puede resolver con las funcionalidades existentes de Next.js / React / TypeScript / Tailwind, no se añade una nueva biblioteca. Si es necesario añadir una biblioteca, primero se revisa:

Por qué es necesario
Qué problema resuelve
Si existe una alternativa

38. Principio de Supabase / Backend

La primera versión del portafolio actual comienza con contenido estático. Se utiliza primero:

content/*.ts

Un backend como Supabase se añadirá cuando surja la necesidad real de:

  • Página de administración
  • CRUD de proyectos
  • Blog
  • Registro de desarrollo
  • Almacenamiento de consultas
  • Autenticación
  • Gestión de datos dinámicos

No se introduce una base de datos en una etapa donde no se necesita un backend.


39. Flujo de Trabajo de Git

Se realiza un commit cuando se completa una unidad de trabajo significativa.

Flujo básico:

git add .
git commit -m "Contenido del trabajo"
git push

Se recomienda el formato de Commit Convencional (Conventional Commit).

Ejemplo:

feat: add portfolio homepage
feat: add project section
style: improve project cards
fix: resolve mobile layout
refactor: simplify project components
docs: update portfolio documentation
chore: update dependencies

No se agrupan las unidades de trabajo de forma excesivamente grande.


40. Estándar de Calidad Final

La pantalla completada debe poder responder "Sí" a las siguientes preguntas:

  • ¿Se ve la identidad del desarrollador en la primera pantalla?
  • ¿Los proyectos se ven como el contenido central?
  • ¿Se entiende qué problema resolvió cada proyecto?
  • ¿Se enfatizan los resultados y procesos reales por encima de la lista de tecnologías?
  • ¿Es fácil de leer en móvil?
  • ¿El contenido y la UI están separados?
  • ¿Se pueden añadir nuevos proyectos fácilmente?
  • ¿No se incluye información que no existe realmente?
  • ¿Da una impresión profesional sin efectos de diseño excesivos?
  • ¿No se ha eliminado innecesariamente la funcionalidad existente?

41. Reglas No Negociables

Los siguientes principios se mantienen siempre:

  1. La decoración no debe superar al contenido.
  2. El proyecto es el núcleo del portafolio.
  3. No crear contenido que no sea una experiencia real.
  4. No añadir arbitrariamente logros o cifras que el usuario no haya proporcionado.
  5. Separar el contenido de la UI.
  6. El Diseño Responsive es obligatorio.
  7. Considerar la Accesibilidad.
  8. No añadir bibliotecas innecesarias.
  9. No eliminar arbitrariamente la funcionalidad existente.
  10. Los cambios estructurales grandes deben confirmarse con el usuario antes de la implementación.
  11. El diseño debe mantener la dirección Profesional / Moderno / Mínimo / Técnico.
  12. Mantener el Modo Claro como valor por defecto en la primera versión.
  13. Diseñar para que no sea necesario modificar el código de UI al añadir proyectos.
  14. Todas las decisiones de diseño priorizan la legibilidad y la transmisión de información.

Skills relacionados