Communitygithub.com

portfolio-build

Construye o reconstruye el sitio web de portafolio de un diseñador para que un revisor lo entienda en 30 segundos, a partir de un archivo de contenido y una de tres rejillas probadas (un perfil fijo junto al trabajo a ancho completo, una rejilla de dos columnas equitativas o un estudio de caso largo por proyecto). Úsalo cuando alguien quiera crear un sitio de portafolio, iniciar un sitio personal para su trabajo de diseño, rediseñar o reestructurar un portafolio existente, convertir una carpeta de imágenes de proyectos o una página de Behance/Dribbble/Notion en su propio sitio, elegir un diseño o rejilla para un portafolio, o aplicar las correcciones de una auditoría de portafolio, incluso si solo dicen

¿Qué es portfolio-build?

Este skill está diseñado para crear sitios de portafolio estáticos, de alta calidad, para diseñadores y artistas visuales, optimizados para causar una excelente primera impresión en aproximadamente 30 segundos. Automatiza la extracción de información del usuario o de materiales existentes (como carpetas de imágenes, páginas de LinkedIn o perfiles de Behance/Dribbble) y genera un sitio web completo a partir de un único archivo de configuración (`portfolio.json`). El skill ofrece tres diseños de rejilla (perfil fijo con trabajo a ancho completo, rejilla de dos columnas o estudio de caso), permitiendo al usuario elegir el que mejor se adapte a su trabajo. Se enfoca en la estructura del sitio, dejando la personalización visual (tipografía, colores, etc.) en manos del usuario. El proceso incluye la redacción de contenido clave (titular, pruebas, roles), la creación de un archivo de contenido con campos bien definidos, la ejecución de un script de Python para construir el sitio, y una guía de entrega que enumera las tareas pendientes (slots) y los problemas detectados. El resultado es un sitio estático listo para publicar, sin dependencias de frameworks.

Compatible con~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/adrituyo/30s/tree/main/skills/portfolio-build

Preguntar en tu IA favorita

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

Documentación

Construcción de portafolio

Un portafolio tiene unos 30 segundos en la primera visita. Este skill construye uno que aprovecha bien esos segundos: quién eres y qué haces en la primera pantalla, trabajo real a su lado, tu papel en cada proyecto indicado, y una forma clara de contactarte.

Corrige la estructura y deja el aspecto visual a la persona. Las tres rejillas deciden dónde va cada cosa y en qué orden. La tipografía, el color, el radio de las esquinas y el espaciado son suyos, configurados en un pequeño bloque. Dos portafolios construidos con este skill deberían leerse igual y no parecerse en nada.

Las rutas a continuación son relativas a la carpeta de este skill.

Cómo funciona

Un solo archivo, portfolio.json, lo contiene todo: quién es la persona, los proyectos, la rejilla elegida y el aspecto visual. Un solo comando lo convierte en un sitio estático (HTML y CSS planos, sin framework, nada que instalar):

python3 scripts/build.py ruta/al/sitio/de/la/persona/portfolio.json

El sitio se escribe junto al archivo de contenido. Luego, el script imprime dos listas: lo que una auditoría de 30 segundos seguiría marcando, cada línea vinculada a un número de regla (references/rules.md tiene las diecisiete en una línea cada una), y cada [slot] que aún espera un dato. Trata ambas como la lista de tareas pendientes.

Pasos

1. Descubre para qué es el portafolio

Pregunta o deduce a partir de lo que te dieron:

  • El objetivo. El rol o cliente al que está dirigido. Decide el titular, el orden y qué se omite.
  • El trabajo. Qué proyectos, y para cada uno: qué era, su papel, para quién fue, el año, una cosa que decidieron y qué pasó como resultado.
  • El material. Dónde están las imágenes y los videos.

Si tienen un sitio existente, léelo primero y traslada lo que ya está allí. Si el skill portfolio-audit está disponible y tienen un sitio en vivo, ejecutarlo primero te dice exactamente qué cambiar.

Pregunta solo por lo que no puedas encontrar. Una persona con una carpeta de imágenes y una página de LinkedIn ya te ha dado la mayor parte. Si no hay nadie para responder, continúa con lo que tienes y usa los slots (paso 3).

El material sobre el que la persona tiene dudas (un cuaderno de bocetos, un proyecto de estudiante, algo antiguo) se queda fuera. Dudaron por una razón, y un portafolio se juzga por su pieza más débil. Di qué omitiste y por qué. Tres proyectos sólidos son un portafolio completo; no añadas relleno para llegar a cuatro.

2. Deja que la persona elija la rejilla

Lee references/grids.md. Describe las tres rejillas y a quién le conviene cada una. La rejilla decide cómo se lee todo el sitio, así que es la elección de la persona, no la tuya. Tu parte es hacer que sea una elección fácil.

Antes de construir, nombra las tres en un mensaje breve, una línea cada una, di cuál recomiendas para su trabajo y objetivo y por qué, y pregunta cuál quiere. Combínalo con cualquier otra cosa que necesites preguntar en el paso 1, para que haya una ronda de preguntas y no dos.

  • Si ya nombraron una rejilla, úsala y no reabras la pregunta.
  • Si eligen una diferente a tu recomendación, construye la suya. Di una vez lo que les cuesta si es relevante (por ejemplo, index no tiene espacio para una decisión y un resultado), luego déjalo.
  • Si no están seguros, o no hay nadie para responder, sigue adelante con tu recomendación y construye con --compare en el paso 5, para que las tres estén disponibles para abrir lado a lado.

Cambiar después es una palabra en el archivo, así que nadie queda atrapado. Esa es una razón para ofrecer la elección con ligereza, no para saltarla.

3. Escribe el archivo de contenido

Copia assets/example/portfolio.json como punto de partida y lee references/content.md para cada campo. Ponlo en la carpeta que se convertirá en el sitio, con las imágenes junto a él. El ejemplo usa la rejilla case; para index y columns, decision y result son opcionales y las filas de antes/después rara vez se necesitan.

Cómo escribir las partes que más importan:

  • Titular: una oración que diga qué hacen y para quién, con un dato. No debería encajar en el sitio de nadie más. "Diseñador de producto para aplicaciones fintech. Ocho años, más recientemente líder del flujo de ahorros en Ledger." No "Creativo multidisciplinario apasionado por crear experiencias."
  • Prueba: los tres o cuatro nombres o números más sólidos, justo después del titular.
  • Orden: el proyecto que mejor se adapte al objetivo va primero, sin importar su fecha. Cuatro a ocho proyectos. Las disciplinas secundarias (cine para un director de arte, ilustración para un diseñador de producto) funcionan mejor como un segundo sitio con su propio archivo de contenido que mezcladas.
  • Cada proyecto: un resumen de una línea, el rol, y si fue para un cliente, un empleador o un concepto personal. Para objetivos de producto y liderazgo, añade la decisión y el resultado.
  • Rol: su título actual tal como es, no el que están solicitando.
  • Solicitud: una oración encima del correo electrónico que diga para qué escribir.
  • Idioma: escribe en el idioma de su audiencia y configura site.lang. Las palabras propias de la plantilla (Index, Facts, Next…) siguen para inglés y español; para cualquier otro idioma, configúralas en labels.

Usa solo datos que la persona te haya dado o que estén en sus páginas existentes. Un dato que hayas deducido tú mismo, como el nombre de un cliente leído de un nombre de archivo, puede usarse, pero dile a la persona que fue inferido para que pueda confirmarlo.

Cuando falte un dato, escribe un slot entre corchetes ([año], [tamaño del equipo], [qué se lanzó]). Los slots aparecen en el sitio exactamente como están escritos y la compilación lista cada uno, así que:

  • Mantén el titular libre de slots: escríbelo con lo que sí sabes. Un slot en la primera oración es lo primero que lee un visitante.
  • Si un campo completo es desconocido y opcional (ciudad, equipo, site.url), omite el campo.
  • Para trabajos sin resultado, di la verdad: "Lanzado en 2024; no tengo los números", "Concepto, no lanzado". Eso es un resultado. Una promesa vacía de impacto no lo es.
  • Un sitio con slots es un borrador. Dilo claramente en la entrega.

Un portafolio con una laguna honesta está bien. Un portafolio con un cliente inventado es un problema en una entrevista.

4. Configura el aspecto visual

En el bloque theme: claro u oscuro, un color de acento, la tipografía, el radio de las esquinas, el espacio entre imágenes. Si la persona tiene una marca o un sitio existente, tómalos de allí. Si no tienen nada, elige una tipografía y un acento que se adapten a su trabajo y di qué elegiste. No copies el aspecto del ejemplo ni del sitio de ningún otro diseñador.

Una tipografía que no esté en todos los dispositivos necesita font_url para cargarla; nombrarla solo en font recurre a la fuente del sistema para la mayoría de los visitantes. Dale ambos, o elige una pila de fuentes del sistema.

5. Construye, mira, corrige

Ejecuta la compilación. Si la persona no ha elegido una rejilla, añade --compare:

python3 scripts/build.py ruta/al/sitio/de/la/persona/portfolio.json --compare

También escribe el mismo contenido en las tres rejillas en una carpeta compare/, con una página que las enlaza. Muestra esa página a la persona y deja que elija. compare/ es solo para elegir: bórrala antes de publicar.

Luego mírala en un navegador en tamaño de escritorio y teléfono si puedes: inicia python3 -m http.server en la carpeta del sitio (la rejilla case enlaza a carpetas de proyecto, que necesitan un servidor) y revisa la primera pantalla tú mismo: nombre, qué hacen, prueba, una forma de contactarlos, y una pieza de trabajo real, sin desplazarte.

Si no puedes abrir un navegador, dilo en la entrega, y al menos mantén el titular y la prueba juntos en unas 45 palabras, que es lo que cabe encima de la primera imagen en un teléfono.

Trabaja con la lista que el script imprimió. Corrige lo que puedas desde el contenido (una línea de rol faltante, una imagen pesada, un titular largo). Entrega el resto a la persona como una lista breve de lo que solo ellos pueden proporcionar.

6. Entrega

Diles: qué rejilla y si la eligieron ellos o tú (y que las otras dos están a una palabra de distancia, o en compare/ si la construiste), qué escribiste para el titular, qué omitiste, cualquier cosa que inferiste, los slots que aún deben llenar, lo que la lista de auditoría aún muestra, y cómo cambiar las cosas (editar portfolio.json, ejecutar la compilación de nuevo). La carpeta es un sitio estático completo: se puede publicar en cualquier servidor estático subiéndolo tal cual.

Solo hay dos cosas que solo ellos pueden proporcionar, así que pregúntalas aquí: la dirección donde vivirá el sitio (site.url), y una imagen de 1200×630 píxeles para las vistas previas de enlaces (site.share_image); un recorte de la mejor imagen del primer proyecto funciona.

Imágenes

  • Exporta a 2000 px de ancho como máximo, en AVIF o WebP, por debajo de unos 500 KB cada una. La compilación advierte sobre las más pesadas. JPEG, PNG y SVG también funcionan.
  • Se usa automáticamente una copia más pequeña para teléfonos cuando los archivos se nombran como un par: shot-lg.jpg en el archivo de contenido y shot-sm.jpg junto a él. Un .avif con los mismos nombres se ofrece primero a los navegadores que lo soportan.
  • Pon a cada imagen un alt que diga lo que muestra. Sin uno, se usa el título del proyecto, que le dice muy poco a un motor de búsqueda o a un asistente de IA. Si no has visto las imágenes, di qué pieza es cada una y pide a la persona que las describa.
  • Los videos cortos en bucle (.mp4, .webm) funcionan como mosaicos. Se reproducen silenciados, solo mientras están en pantalla. Ponles un ratio.

Qué no hacer

  • No añadas una animación de introducción, un cargador, un cursor personalizado o efectos de desplazamiento que retrasen el contenido. La plantilla muestra la primera pantalla de inmediato a propósito.
  • No ocultes los títulos de los proyectos detrás del hover. Los teléfonos no tienen hover.
  • No elimines el dock, la pequeña barra con el nombre y el correo electrónico que aparece una vez que el bloque de contacto se ha desplazado fuera de la vista. Un revisor decide escribir en medio de un proyecto, no al final de la página.
  • No rellenes trabajos pobres con imágenes de proceso (notas adhesivas, personas). Una decisión, dicha claramente, vale más.
  • No edites el HTML generado a mano: la siguiente compilación lo sobrescribe. Cambia el archivo de contenido, o la plantilla en assets/template/ si la estructura misma necesita cambiar.

Individual skills in this repo

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

Skills relacionados