Constructor de Portafolios
Construye un sitio web de una página, orientado a reclutadores, para mostrar un proyecto de hackathon. El sitio es el entregable incluso cuando el proyecto en sí no es una aplicación web: una construcción de hardware, un modelo de ML, una CLI o un proyecto de investigación, todos reciben un sitio que muestra el trabajo a través de video, diagramas, fotos y réplicas interactivas. Apunta al nivel establecido por estos sitios de caso de estudio: dispatchai.art3m1s.me, talktuah.art3m1s.me, slugloop.com y adapted.art3m1s.me. Cada uno no se parece a los demás, porque cada diseño se extrae del propio mundo del proyecto. Esa singularidad es el objetivo principal, y es por eso que esta skill se apoya en la skill de diseño frontend en lugar de una plantilla fija.
Paso 1: Hacer disponible el motor de diseño
El diseño proviene de la skill frontend-design de Anthropic, y es lo que evita que el resultado se lea como una página de IA genérica. Debe estar disponible antes de diseñar cualquier cosa.
Esto es un requisito previo del usuario, no algo que el agente pueda hacer por sí mismo, porque el agente no puede ejecutar comandos de barra. Si frontend-design ya aparece en tus habilidades disponibles, estás listo. Si no es así, pídele al usuario que instale el plugin en Claude Code ejecutando estos dos comandos:
/plugin marketplace add anthropics/claude-plugins-official
/plugin install frontend-design@claude-plugins-official
La primera línea solo es necesaria si ese marketplace aún no está agregado. Claude también aplica frontend-design automáticamente para trabajo frontend, por lo que sus principios ya pueden estar en juego, pero pídele al usuario que confirme en lugar de asumir que el plugin está presente. Cada decisión de diseño en el Paso 3 pasa a través de él.
Paso 2: Recopilar los hechos
Detecta primero, pregunta después. Lee AGENTS.md, PRD.md, el README, package.json y cualquier foto, captura de pantalla o diagrama que ya esté en el repositorio. Luego pregunta solo por lo que falta:
- Nombre del proyecto y un eslogan que nombre lo que está en juego, no la tecnología.
- Tipo de proyecto: aplicación web, hardware o IoT, modelo de ML, CLI o herramienta de desarrollo, aplicación móvil, o investigación y datos. Esto decide cómo lo muestras en el Paso 4.
- El problema, con una estadística real y su fuente.
- Qué hace: de tres a cinco capacidades principales.
- Cómo funciona: suficiente del sistema para dibujar un diagrama de arquitectura.
- Prueba: video demo (YouTube), URL en vivo, Devpost, GitHub, cobertura de prensa y cualquier artefacto de código abierto (modelo, conjunto de datos, Figma).
- Material del evento: las fotos y clips espontáneos del hackathon, que el repositorio casi nunca contiene. Pide explícitamente fotos del equipo y del progreso de la construcción, fotos del día de la demostración o del escenario y premios, bocetos en pizarra o servilleta, y el lugar, además de dónde viven (un teléfono, una unidad compartida, la galería de Devpost). Estos son lo que hacen que el sitio se sienta real, así que solicítalos en lugar de asumir que el repositorio los tiene. Si no existen, recurre a capturas de pantalla, diagramas y el video demo.
- Resultados: premios y colocación, nombre del evento, fechas, escala y rango, tiempo de construcción, tamaño del equipo y cualquier métrica (commits, latencia, usuarios).
- Equipo: nombres, roles, handles de GitHub, URLs de LinkedIn y fotos de perfil.
Nunca inventes un premio, estadística, premio, rango o cita. Si un hecho es desconocido después de preguntar, omite esa sección en lugar de adivinar.
Paso 3: Diseñarlo a través de frontend-design
Entrega a frontend-design un resumen construido a partir del Paso 2 y ejecuta su ciclo completo: lluvia de ideas, exploración, planificación, crítica, construcción y crítica nuevamente. Su regla principal se aplica aquí: deriva la apariencia del tema, no de un valor predeterminado. Produce un sistema de tokens compacto específico para este proyecto:
- Paleta: de cuatro a seis valores hexadecimales nombrados extraídos del mundo del proyecto. Un despachador del 911 se lee como rojos y ámbares de severidad sobre casi negro; un banco de voz se lee como azules de confianza; una construcción de malla de bicicletas de UCSC se lee como una paleta de archivo de "bitácora de campo" desgastada.
- Tipografía: una cara de exhibición con carácter usada con moderación, una cara de cuerpo complementaria y una cara utilitaria o mono para datos, emparejadas deliberadamente en lugar de las mismas familias que recibe cada proyecto.
- Diseño: una página única con desplazamiento narrativo que sigue el esqueleto del Paso 5.
- Movimiento: un momento de movimiento orquestado que sirve al tema, como una revelación de arquitectura activada por desplazamiento o una repetición de telemetría. Los efectos dispersos se leen como generados por IA, así que gasta movimiento en un solo lugar. Esto es independiente del piso de accesibilidad de movimiento reducido en el Paso 6.
- Firma: el elemento único por el que este sitio es recordado, que encarna este proyecto. Dispatch tiene una consola de operador interactiva incorporada que se ejecuta con datos sembrados; Slugloop tiene su marco de archivo "los receptores ya no hacen ping"; AdaptEd tiene sus bucles de aprendizaje numerados.
Dos protecciones heredadas de frontend-design:
- Evita las apariencias predeterminadas de IA a menos que el mundo del proyecto realmente las requiera: (1) un fondo crema con una serifa de alto contraste y un acento terracota, (2) casi negro con un solo acento verde ácido o bermellón, (3) reglas de línea fina de periódico sin radio de borde y columnas densas. Si tu plan de paleta y tipo de letra cae en uno de estos por reflejo, revísalo y di por qué.
- La estructura es información. Usa marcadores numerados, cejas y divisores solo cuando codifican algo verdadero, como una secuencia real (los bucles de AdaptEd), nunca como decoración. La numeración del esqueleto del Paso 5 es una lista de verificación de autoría, no un tratamiento visual obligatorio.
Las etiquetas de las secciones también son superficie de diseño. El esqueleto es la estructura subyacente; renombra sus encabezados a la voz del proyecto ("Bitácora de campo" en lugar de "Vitrina", una línea dentro del mundo en lugar de "Límites honestos", numerados del 01 al 0N donde se ajuste al tema). Ejecuta la puerta de planificar-luego-criticar antes de construir: si alguna elección se lee como la página que producirías para cualquier proyecto similar, revísala. Construye solo una vez que el plan sea genuinamente específico para este resumen.
Paso 4: Elegir cómo mostrar el trabajo
El sitio muestra el proyecto independientemente del tipo de cosa que sea. El piso universal es el video demo más el artefacto principal del proyecto, sea lo que sea: imágenes, fotos, una repetición de telemetría, una figura de evaluación o una repetición de terminal. Luego elige el dispositivo de exhibición principal según el tipo de proyecto:
- Aplicación web: un widget o consola interactiva incrustado que se ejecuta con datos sembrados (la consola del operador de Dispatch), con una vista de solo lectura como alternativa solo cuando la interactividad no es factible.
- Hardware o IoT: fotos de construcción, un diagrama de cableado o sistema, imágenes de campo y un mapa o repetición de telemetría (Slugloop).
- Modelo de ML: un widget de inferencia interactivo o un antes y después, además de los números de evaluación y un enlace a Hugging Face.
- CLI o herramienta de desarrollo: una repetición de terminal (estilo asciinema) o una secuencia de comandos animada.
- Móvil: un video con marco de dispositivo o un flujo de pantalla en el que se puede hacer clic.
- Investigación o datos: la figura clave, los gráficos y el diagrama de metodología.
Las demostraciones pueden ser plurales. Ofrece dos modos de demostración cuando sea útil (un recorrido pasivo más un modo interactivo, como TalkTuah), o empareja un clip de prototipo temprano con un clip de campo final para mostrar iteración (Slugloop). Solo simula una réplica cuando un backend real no pueda ejecutarse en un sitio estático; cuando lo hagas, siémbralo con datos realistas y etiquétalo claramente como una réplica. Un sitio de hardware construido con imágenes de campo reales no necesita simulación ni dicha etiqueta.
Si el proyecto obtuvo cobertura de prensa real, trátalo como un dispositivo de credibilidad: renderiza los recortes como tarjetas o logotipos de medios con una cita y fuente (Slugloop), no como enlaces simples.
Paso 5: El esqueleto del caso de estudio
Un desplazamiento de una sola página, primero para reclutadores. Trátalo como un menú: incluye una sección solo cuando existan los hechos y renombra su encabezado a la voz del proyecto (ver Paso 3). La numeración aquí es una lista de verificación de autoría, no un estilo visual obligatorio.
- Héroe (tesis): abre con lo más característico del proyecto, más el eslogan y los CTA principales (demo, Devpost, GitHub). Mantén visible el premio o credencial principal.
- Franja de credibilidad: colocación, premio, rango, tamaño del campo.
- Problema: lo que está en juego y una estadística con fuente.
- Qué hace: las capacidades principales. Las tarjetas de capacidad pueden enlazar profundamente o anclar al desplazamiento en la parte correspondiente de la sección de arquitectura, vinculando el qué con el cómo (TalkTuah).
- Cómo funciona: el diagrama de arquitectura o sistema, donde se muestra la profundidad de ingeniería.
- Vitrina: el dispositivo elegido en el Paso 4 (widget interactivo, video o videos, fotos, repetición de telemetría). Permite un bloque de video dual o de iteración cuando corresponda.
- En números: una cuadrícula de estadísticas audaces con cifras grandes y etiquetas cortas. Puede fusionar el tamaño del equipo, el tiempo de construcción, los commits y el rango en un bloque de firma (Slugloop: 4 estudiantes, 36 horas, 500+ commits, Top 10). El rango también puede aparecer en la franja de credibilidad.
- Prensa (opcional): cobertura real como tarjetas de recortes o logotipos de medios con una cita y fuente.
- Equipo o tripulación: biografías con roles, GitHub y LinkedIn.
- Límites honestos: qué es y qué no es una construcción de fin de semana. Nombrar las concesiones se lee como madurez, no como debilidad.
- Enlaces y fuentes: GitHub, Devpost, YouTube, modelo o conjunto de datos, prensa.
- Pie de página: construido en N horas en el evento, con enlaces al repositorio y en vivo.
Paso 6: Construirlo
- Construye un sitio independiente de una sola página que sea exportable estáticamente y listo para Vercel, usando por defecto Next.js (App Router). Coincide con la pila existente del proyecto si la tiene. Ponlo en su propia carpeta (
site/oportfolio/) o en un repositorio separado para que no se enrede con el código del producto. - Usa contenido real en todo momento; sin lorem. Sigue la guía de escritura de frontend-design: llana, específica, escrita desde el lado de la pantalla del lector.
- Mantén un piso de calidad sin anunciarlo: responsivo hasta móvil, enfoque de teclado visible y movimiento reducido respetado.
- Cubre lo básico de SEO: un título y descripción conscientes de palabras clave, una URL canónica, una imagen de Open Graph, exactamente un
h1y secciones semánticas. - Usa capturas de pantalla, fotos y diagramas reales, incluido el material del evento recopilado en el Paso 2 colocado en las secciones de vitrina, equipo y en números; si envías una réplica simulada, etiquétala; usa el póster de YouTube para la demo.
- Vuelve a criticar después de que se renderice, según lo indica frontend-design: captura la página, vuelve a preguntar "¿habría producido esta misma apariencia para un proyecto no relacionado?" y elimina un accesorio cortando una decoración que no sirve al resumen.
Verificar
frontend-designse usó realmente, y el resultado no se lee como un valor predeterminado de IA genérico ni cae en uno de los tres looks predeterminados. Aplica su autocrítica después de la construcción: ¿habrías producido esta misma apariencia para un proyecto no relacionado?- Un
h1, encabezados semánticos, responsivo móvil, estados de enfoque visibles, movimiento reducido respetado. - Cada premio y estadística es real, cualquier réplica simulada está etiquetada, cada enlace resuelve y el video o videos de demostración se integran.
- Construye y previsualiza localmente; verifica Core Web Vitals o un pase de Lighthouse si es práctico.
Resultado final
- El sitio: ruta o ruta, y cómo ejecutarlo.
- Sistema de diseño: la paleta, el emparejamiento tipográfico, el momento de movimiento y el elemento de firma, con una línea sobre por qué cada uno se ajusta a este proyecto.
- Dispositivo de vitrina: cuál usaste y por qué se adapta al tipo de proyecto.
- Hechos utilizados vs. omitidos: qué entró y qué secciones se omitieron por falta de hechos reales.
- Despliegue: los pasos para enviarlo a Vercel.
- Próximos pasos: por ejemplo, un dominio personalizado y vincular el sitio desde el README y una publicación de LinkedIn.
Límites
- Haz que
frontend-designesté disponible primero, y nunca envíes un valor predeterminado con plantilla. El diseño debe ser específico para este proyecto. - Nunca inventes premios, estadísticas o prensa, y siempre etiqueta las réplicas simuladas.
- Mantén una página enfocada. No reconstruyas todo el producto.
- Describe lo que realmente existe. El sitio refleja el proyecto real, no una versión aspiracional.