Communitygithub.com

Creador de portafolio

Construye un portafolio personal con carácter para un diseñador, desarrollador, fotógrafo, escritor o freelancer, con estructura clara, tipografía elegida y movimiento contenido.

¿Qué es Creador de portafolio?

Habilidad reutilizable para un sitio de portafolio: presentar a la persona, mostrar el trabajo y evitar la plantilla genérica.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MorganMarshall/ZeroSkills/tree/HEAD/skills/zero-web-design-portfolio

Preguntar en tu IA favorita

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

Documentación

Portafolio de Diseño

Construye un portafolio que haga tres cosas bien: presente a la persona, muestre su trabajo con contexto y facilite el contacto. Un portafolio no es una página de aterrizaje — los visitantes quieren explorar, no ser encaminados. Diseña para el descubrimiento.

Trabajo en tres pasos

  1. Planifica. Decide la dirección y estructura antes de escribir código (ver más abajo).
  2. Construye. Implementa el plan con tokens de diseño, para que cada color, tamaño y espacio provenga de un sistema.
  3. Revisa. Evalúa el resultado contra la lista de verificación al final y corrige lo que falte.

Si el resumen del usuario nombra un estilo, paleta, fuente o diseño, síguelo exactamente. Sus palabras siempre prevalecen sobre los valores predeterminados de esta habilidad.

1. Planifica antes del código

Escribe un plan breve que incluya:

  • Quién es esta persona y qué hace. El rol, disciplina, nivel de seniority de la persona, y quién visitará el sitio (reclutadores, clientes, colaboradores, otros diseñadores). Si el resumen no lo dice, propón uno en una oración y menciona que lo asumiste.
  • Dirección estética. Elige una (minimalista editorial, técnica suave, cálido artesanal, documental austero, experimental) y comprométete, con una razón de una línea vinculada al trabajo de la persona. El portafolio de un fotógrafo y el de un desarrollador front-end deben verse diferentes.
  • Tokens. De cuatro a seis colores nombrados como valores hex, las tipografías y sus roles, la unidad de espaciado, la escala de radio y el estilo de sombra. Los portafolios a menudo se benefician de un acento muy claro o nulo — deja que el trabajo lleve el color.
  • Idea para el héroe. Presenta quiénes son y un proyecto representativo, o una introducción breve de dos líneas con un enlace al trabajo. Evita efectos de escritura animada e imágenes de archivo genéricas.

Luego verifica el plan contra el resumen. Si alguna parte es lo que producirías para cualquier solicitud similar, cambia esa parte y anota qué cambiaste. Un plan genérico produce un portafolio genérico.

2. Sistema de diseño

Color

  • Define la paleta como propiedades personalizadas de CSS en :root: una escala neutra (fondo, superficie, borde, texto atenuado, texto), un acento primario y opcionalmente uno secundario.
  • Los portafolios a menudo se ven mejor con acento atenuado o nulo. Deja que el trabajo — imágenes, capturas de pantalla, estudios de caso — proporcione el color. Usa el acento solo para enlaces, estados activos y uno o dos aspectos destacados deliberados.
  • Soporta claro y oscuro con prefers-color-scheme redefiniendo los tokens, no sobrescribiendo reglas individuales.
  • Mantén el contraste en 4.5:1 para el texto del cuerpo y 3:1 para texto grande y bordes de interfaz.

Tipografía

  • Usa como máximo dos familias. Si son dos, dales roles claramente diferentes (una cara display para el nombre y titulares, una cara de texto para lectura).
  • Elige caras según la disciplina en lugar del primer predeterminado que venga a la mente, y carga fuentes web con font-display: swap y una pila de respaldo completa.
  • Construye una escala tipográfica (proporción alrededor de 1.2 a 1.333) y haz los titulares fluidos con clamp().
  • Ajusta el nombre de la persona y los encabezados de sección con poco interlineado (altura de línea 1.05 a 1.15, espaciado de letras ligeramente negativo en tamaños grandes). Texto del cuerpo abierto (16 a 18 px, altura de línea 1.5 a 1.7).
  • Mantén la longitud de línea entre 45 y 75 caracteres (max-width: 65ch es un buen valor predeterminado).

Diseño y espaciado

  • Usa una escala de espaciado de 4/8px definida como tokens, y úsala en todas partes.
  • Dale a las secciones espacio para respirar: de 80 a 120 px de relleno vertical en escritorio, de 48 a 64 px en móvil.
  • Limita el contenedor a aproximadamente 1100 a 1200 px, y mantén el texto de lectura más estrecho.
  • Construye primero para móvil con CSS grid y flexbox. Todo debe funcionar desde 360 px hacia arriba sin desplazamiento horizontal; las imágenes, código y diagramas anchos se desplazan dentro de su propio contenedor.
  • Varía el ritmo entre secciones (densidad, alineación, escala) en lugar de repetir un bloque. Alinea a la izquierda el texto largo.
  • Usa una cuadrícula clara para la galería de proyectos (dos o tres columnas en escritorio, una en móvil). Varía las relaciones de aspecto entre proyectos cuando los activos lo permitan — no todos los proyectos necesitan una tarjeta uniforme.

Superficies y componentes

  • Usa un sistema de radio con dos o tres tamaños, combinados con la jerarquía (más pequeño en entradas y botones, más grande en contenedores).
  • Usa bordes de 1 px de bajo contraste en lugar de sombras pesadas para las tarjetas de proyecto. El trabajo del portafolio debe verse como si estuviera sobre la página, no apilado encima.
  • Dale a cada elemento interactivo estados hover, :focus-visible, activo y deshabilitado. Nunca elimines un contorno sin reemplazarlo.
  • Un botón principal por vista, etiquetado específicamente ("Ver proyecto", "Ponte en contacto"), con un objetivo táctil de al menos 44 px.
  • Las tarjetas de proyecto deben mostrar: el título del proyecto, un descriptor corto (rol, año, tecnología) y la imagen principal o captura de pantalla. Sin etiquetas genéricas como "Característica uno".

Movimiento

  • Usa transiciones de 150 a 250 ms con salida suave para cambios de estado, para que el movimiento muestre qué cambió.
  • Prefiere un momento orquestado (una secuencia de carga de página o una revelación de héroe) sobre animaciones de entrada en cada sección.
  • Anima solo transform y opacity.
  • Respeta prefers-reduced-motion desactivando el movimiento no esencial.
  • Para la galería de proyectos, una sutil escala hover o revelación de borde es suficiente. No agregues superposiciones hover que oculten la imagen del proyecto.

Imágenes e iconos

  • Nunca envíes imágenes rotas o de marcador de posición. Usa los activos proporcionados, o genera bloques limpios de CSS/marcador de posición que indiquen dónde va la imagen (etiquetados con el nombre del proyecto).
  • Usa relaciones de aspecto consistentes para las miniaturas de proyectos, o una cuadrícula estilo masonry si los activos varían mucho.
  • Mantén un conjunto de iconos con un grosor de trazo para enlaces sociales y elementos de interfaz. Escribe texto alternativo significativo.
  • Para estudios de caso, usa capturas de pantalla reales, maquetas o fotos. Sin lorem ipsum ni bocetos de wireframe como trabajo final.

3. Estructura de página

Un portafolio típicamente sigue este arco:

  • Héroe: quiénes son (nombre + rol), una oración sobre lo que hacen o su enfoque actual, y un enlace claro al trabajo. Detalles de contacto o enlaces sociales cerca.
  • Trabajo seleccionado: una galería curada de 4 a 8 proyectos. Cada elemento enlaza a una página de detalle o sección ampliada. Calidad sobre cantidad.
  • Acerca de (opcional): un párrafo breve sobre antecedentes, intereses y dónde encontrarlos. Una foto si la tienen — una foto informal está bien, no es necesario un retrato profesional a menos que lo quieran.
  • Contacto: una forma simple de contactarlos — enlace de correo electrónico, formulario de contacto o enlaces a canales preferidos. Hazlo visible sin desplazarse en móvil.
  • Pie de página: enlaces sociales (GitHub, LinkedIn, Dribbble, Instagram, etc.), derechos de autor y quizás un eslogan corto.

Páginas de detalle de proyectos / estudios de caso:

  • Nombre del proyecto, rol, año, pila tecnológica y enlace al proyecto en vivo o repositorio.
  • El problema o contexto en uno o dos párrafos.
  • Capturas de pantalla, maquetas o recorridos con anotaciones breves.
  • Lo que aprendieron o lo que harían diferente (esto es lo que separa los portafolios reales de los reels destacados).
  • Un enlace al siguiente proyecto para continuar explorando.

Redacción

  • Escribe copia real y específica. Sin lorem ipsum ni "Característica uno".
  • Usa el nombre real y el rol de la persona, no una persona ficticia.
  • Escribe desde el punto de vista del visitante en palabras sencillas, con mayúscula inicial y voz activa.
  • Haz que los títulos de los proyectos digan qué es el proyecto, no abstracciones ingeniosas. "Panel de control CRM para clientes" es mejor que "Motor de sinergia."
  • Mantén las descripciones de proyectos en dos o tres oraciones: qué es, qué hiciste y el resultado si lo hubo.

Base técnica

  • Usa HTML semántico (header, nav, main, section, footer), un solo h1 y niveles de encabezado en orden.
  • Haz todo navegable por teclado, agrega un enlace de salto en páginas largas y usa ARIA solo donde los elementos nativos sean insuficientes.
  • Incluye la metaetiqueta viewport, un título, una descripción y un favicon.
  • Mantén las dependencias al mínimo. Un portafolio pequeño puede ser un solo archivo HTML autocontenido con CSS y JS en línea. En un proyecto existente, sigue su pila y convenciones en lugar de introducir nuevas.
  • Prevén el cambio de diseño estableciendo ancho y alto o aspect-ratio en los medios.
  • Enlaza a repositorios externos y demostraciones en vivo con etiquetas claras ("GitHub", "Sitio en vivo").

Señales comunes a evitar

Estas aparecen en portafolios construidos sin un punto de vista:

  • Un héroe genérico "Hola, soy [Nombre], un [Rol]" con una ilustración de archivo o avatar de píxeles.
  • Barras de habilidades o porcentajes ("90% HTML", "80% JavaScript"). Nadie las lee y no significan nada.
  • Una cuadrícula de tarjetas uniforme donde cada proyecto tiene la misma relación de aspecto, sombra y efecto hover.
  • Una línea de tiempo animada difícil de leer en móvil.
  • Cada tarjeta de proyecto con la misma superposición degradada al pasar el ratón.
  • Un botón "descargar currículum" que en realidad enlaza a una URL de Google Docs.
  • Una página llena de enlaces sin trabajo que ver.

Revisión final

Antes de presentar el trabajo, verifícalo (con una captura de pantalla o navegador si está disponible):

  • El espaciado y la alineación siguen la escala, sin valores dispersos.
  • El contraste y los anillos de enfoque pasan, y cada estado interactivo existe.
  • El diseño se mantiene en 360 px, tableta y escritorio.
  • Nada es marcador de posición, roto o sin etiqueta.
  • La galería de trabajo se siente curada, no exhaustiva — cuatro proyectos sólidos son mejores que diez mediocres.
  • Un desconocido puede decir quién es la persona, qué hace y cómo contactarla en cinco segundos de ver la página de inicio.
  • Cada proyecto enlaza a un lugar real o una página de detalle plausible, y los enlaces externos están claramente etiquetados.

Individual skills in this repo

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

Skills relacionados