Communitygithub.com

portfolio-maker

Construye un portafolio personal listo para producción para ingenieros, diseñadores, editores, investigadores o consultores, como una aplicación React o un único archivo HTML.

¿Qué es portfolio-maker?

Portfolio Maker es una habilidad de IA autónoma y autosuficiente diseñada para generar portafolios profesionales de alta calidad, eliminando el aspecto genérico y amateur conocido como 'AI slop'. Su motor estético nativo aplica leyes matemáticas de diseño, como jerarquía tipográfica precisa, ritmo espacial basado en una cuadrícula de 8 píxeles, elevación de superficies con bordes finos y paletas de colores curadas (como Titanio Monocromo o Esmeralda y Pizarra). La habilidad cuenta con un arsenal de más de 11,750 componentes categorizados, incluyendo héroes interactivos (ImageStreamHero, PerspectiveTunnelHero) y primitivas como fondos Aurora, tarjetas con efecto Spotlight, un selector de modo oscuro/claro y un botón de copia de correo con un solo clic. Portfolio Maker opera en dos modos: genera una aplicación completa React + Vite + Tailwind (TypeScript) o un único archivo HTML autónomo con Tailwind y JavaScript, ideal para despliegue inmediato en GitHub Pages. El flujo de trabajo incluye extracción de currículum, alineación interactiva obligatoria para personalizar la estética y los componentes, y una auditoría final que verifica el cumplimiento del 'Código de Honor Anti-Slop' para garantizar un resultado profesional y métrico.

Compatible con~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/NaitikGrover/portfolio-maker/tree/HEAD

Preguntar en tu IA favorita

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

Documentación

Portfolio Maker: Habilidad de Diseño e Ingeniería Soberana

Soberana y Autónoma: Esta habilidad opera con total autonomía. No depende, delega ni requiere ninguna habilidad de diseño o animación externa de terceros. Toda la intuición estética, las matemáticas tipográficas, la armonía espacial, la dinámica de micro-interacciones, la eliminación de contenido genérico ('slop') y los componentes primitivos están integrados de forma nativa en esta habilidad.


🎯 Propósito y Misión Principal

Eliminar los portafolios genéricos y amateurs ('AI slop') y producir de forma autónoma portafolios de calidad profesional y listos para producción para cualquier profesional en 5 arquetipos principales:

  1. Ingenieros de Software y Arquitectos de Sistemas (Sistemas distribuidos, APIs de alto rendimiento, estilo 'bento' técnico y limpio)
  2. Editores de Video, Motion Graphics y Creadores (Reels virales, comparaciones antes/después de gradación de color, métricas de visualizaciones)
  3. Diseñadores de Producto y Líderes de UI/UX (Sistemas de diseño, casos de estudio, tipografía suiza de alto contraste, desglose de tokens)
  4. Investigadores de IA/ML e Ingenieros de Datos (Arquitecturas de modelos, publicaciones en arXiv, telemetría de benchmarks, insignias de pesos)
  5. Agencias, Consultores y Solopreneurs (Prueba social, reseñas de clientes, niveles de servicio, conversión de reservas sin fricción)

🚫 El Código de Honor Anti-'AI Slop' (APLICACIÓN ESTRICTA)

Cada portafolio generado DEBE pasar este riguroso filtro estético antes de generar el código:

1. Elementos Visuales Prohibidos:

  • ❌ NUNCA uses el cliché del gradiente neón púrpura/violeta: No uses from-purple-500 via-indigo-500 to-pink-500 en titulares. No uses orbes de fondo borrosos de color púrpura (bg-purple-500/10 blur-3xl).
  • ❌ No uses cuadrículas grises planas y aburridas: Evita los bloques predeterminados de Tailwind bg-gray-100 / border-gray-300 sin profundidad ni textura.
  • ❌ No uses bordes láser sobresaturados: Evita los trazos de neón synthwave de alta intensidad.

2. Paletas de Colores Aprobadas (Élite):

  • Monocromo Titanio (Suizo Oscuro/Claro): Lienzo obsidiana profundo (#09090b), capa de tarjeta elevada (#121215 con backdrop-blur-md), bordes finos (border-white/[0.08]), titulares blancos nítidos (#ffffff), texto atenuado zinc (#a1a1aa), focos sutiles de pizarra/blanco (rgba(255,255,255,0.06)).
  • Esmeralda y Pizarra de Precisión: Lienzo obsidiana (#09090b), indicador de estado activo esmeralda (#10b981), tarjetas monocromáticas con sutiles acentos menta al pasar el ratón.
  • Cobalto Eléctrico Internacional: Lienzo carbón oscuro (#0a0a0f), tipografía blanca nítida, botones y objetivos de interacción azul real eléctrico de alto contraste (#2563eb).
  • Arena Arquitectónica Cálida y Espresso: Lienzo crema cálido (#fafaf9), titulares espresso intensos (#18181b), acentos sutiles de champán/ámbar (#d97706).
  • Rosa y Ámbar Cinematográficos: Lienzo obsidiana #0b0c10, acentos de rosa de alto impacto (#e11d48) y ámbar cálido (#f59e0b) para creativos y reels de video.

3. Texto Relleno Prohibido ('Fluff'):

  • ❌ Prohibido: "Desarrollador apasionado transformando ideas en soluciones digitales elegantes."
  • ❌ Prohibido: "Innovando en la intersección del diseño, la tecnología y la empatía."
  • ❌ Prohibido: "Profesional orientado a resultados con talento para la resolución de problemas."
  • ✅ Requerido: Declaraciones concretas, basadas en métricas y centradas en el impacto:
    • "Construí microservicios Go distribuidos que manejan 120k req/s con una latencia p99 de 14 ms."
    • "Edité documentales virales de formato largo en YouTube que generaron más de 75 millones de visitas orgánicas."
    • "Lideré el sistema de tokens de diseño de Figma para múltiples marcas, adoptado por 42 equipos de ingeniería."

🧠 El Motor Estético Nativo (Inteligencia de Diseño Integrada)

La IA debe aplicar estas leyes matemáticas de diseño a cada elemento:

1. Jerarquía Tipográfica y Ritmo Óptico

  • Titulares de Pantalla (text-4xl a text-6xl md:text-7xl) :
    • El interlineado debe ser ajustado (leading-[1.08] a leading-[1.12]). Un interlineado suelto en fuentes grandes se ve amateur.
    • El espaciado entre letras debe ser comprimido (tracking-tight o tracking-tighter).
    • Pesos de fuente: Negrita o Extranegrita (font-bold / font-extrabold) para técnico; Mediana o Seminegrita (font-medium / font-semibold) para serif editorial.
  • Cuerpo de Texto (text-base a text-lg) :
    • El interlineado debe ser generoso (leading-relaxed o leading-7) para garantizar la legibilidad.
    • Longitud de línea (Medida): Limita el ancho del cuerpo de texto usando max-w-xl o max-w-2xl (45–75 caracteres por línea). Nunca permitas que los párrafos se extiendan a lo ancho de la pantalla.
    • Alineación del texto: Nunca centres más de 3 líneas consecutivas de texto del cuerpo. Alinea a la izquierda para una ergonomía de lectura humana.
  • Combinaciones de Fuentes Curadas:
    • Tech Moderno: Inter o Geist Sans + JetBrains Mono para etiquetas y código.
    • Creativo de Alto Impacto: Plus Jakarta Sans o Syne + Inter.
    • Editorial y Lujo: Cormorant Garamond (serif para display) + Inter (sans para cuerpo).

2. Ritmo Espacial y la Cuadrícula Matemática de 8pt

  • Relleno de Secciones: Espacio de respiración vertical generoso (py-20 md:py-28). Las secciones ajustadas asfixian el diseño.
  • Apilamiento de Diseño: El espaciado vertical entre secciones principales debe usar space-y-24 o space-y-28.
  • Cuadrículas de Tarjetas: Estandariza con gap-6 o gap-8.
  • Contenedores de Ancho de Contenido:
    • Editorial / Minimalista: max-w-4xl mx-auto px-6
    • Bento para Desarrolladores: max-w-5xl mx-auto px-4 sm:px-6
    • Reel Multimedia: max-w-6xl mx-auto px-4 sm:px-6

3. Elevación de Superficie y Ciencia de los Bordes Finos

  • Capa 0 (Lienzo) : #09090b (Oscuro) / #fafaf9 o #ffffff (Claro).
  • Capa 1 (Base de Tarjeta) : #121215 / bg-white dark:bg-zinc-900/60 con backdrop-blur-md.
  • Capa 2 (Bordes Finos) : border border-zinc-200/80 dark:border-zinc-800/80 o border border-white/[0.08]. Nunca uses sombras pesadas y embarradas.
  • Capa 3 (Micro-Hover) : Foco radial que sigue al cursor (rgba(255,255,255,0.06)), o un sutil brillo de borde hover:border-zinc-400 dark:hover:border-zinc-700, más un sutil levantamiento hover:-translate-y-0.5 transition-all duration-300.

4. Detalles Interactivos y Acabado

  • Indicador de Estado en Vivo:
    <div class="inline-flex items-center gap-2 px-3 py-1.5 rounded-full text-xs font-medium bg-emerald-500/10 text-emerald-600 dark:text-emerald-400 border border-emerald-500/20">
      <span class="w-2 h-2 rounded-full bg-emerald-500 animate-pulse"></span>
      <span>Disponible para Oportunidades en Q1 2026</span>
    </div>
    
  • Píldora de Copia de Correo con un Solo Clic (con retroalimentación visual) : Proporciona copia instantánea al portapapeles con una transición de tooltip que confirma "¡Copiado!".
  • Conmutador de Modo Dual (Tema) : Incluye siempre un conmutador de tema funcional (Oscuro / Claro) con morfología de icono y persistencia en localStorage.

📦 Arsenal de Componentes Verificados (Acceso Directo)

La habilidad incluye primitivas TSX listas para producción y catálogos completos verificados:

1. Héroes de Firma (components-library/heroes/):

  • ImageStreamHero.tsx: Carriles de transmisión con profundidad (creadores y editores de video).
  • PerspectiveTunnelHero.tsx: Perspectiva espacial 3D en el eje Z con métricas en vivo (ingenieros y arquitectos).
  • ProductRailGallery.tsx: Perchero interactivo con física de balanceo (e-commerce y moda).
  • TiltedGridHero.tsx: Transmisión de imágenes 3D curvada hacia el espectador (diseñadores UI/UX y fotógrafos).
  • PrismHero.tsx: Estética de refracción de cristal cromático (directores de arte y portafolios de lujo).
  • TigerTearRevealHero.tsx: Efecto de revelación de desgarro interactivo (creativos de alto impacto).
  • AgencyHero01.tsx: Héroe de agencia de alta confianza con avatares sociales e insignias de calificación (freelancers y agencias).
  • ResponsiveHeroBanner.tsx: Banner cinematográfico con navegación glassmórfica (fundadores y líderes).
  • CenteredImageFanHero.tsx: Titular destacado con collage de 3 imágenes en abanico (diseñadores de producto).

2. Primitivas Interactivas Independientes (components-library/):

  • Fondos: backgrounds/AuroraBackground.tsx (ondas sutiles de esmeralda/cian/pizarra, sin neón púrpura).
  • Tarjetas Interactivas: cards/SpotlightCard.tsx (brillo que sigue al ratón), cards/Card3D.tsx (inclinación de perspectiva), cards/BorderBeam.tsx (haz de borde fino animado), cards/Meteors.tsx (partículas de estrellas fugaces).
  • Secciones y Diseños: sections/BentoGrid.tsx (cuadrícula asimétrica responsiva), sections/InfiniteMarquee.tsx (teletipo continuo de tecnología/logos), sections/BeforeAfterSlider.tsx (comparación interactiva de imágenes/video), sections/VideoModal.tsx (ventana emergente de video cinematográfica), sections/TerminalWidget.tsx (CLI interactiva simulada).
  • Controles de UI: ui/FloatingNav.tsx (barra de navegación flotante en píldora glassmórfica), ui/ShimmerButton.tsx (botón de acción con brillo), ui/TextGenerateEffect.tsx (revelación de palabras escalonada), ui/CopyEmailButton.tsx (píldora de copia con un clic), ui/ThemeToggle.tsx (conmutador de tema oscuro/claro).

3. Índice Maestro de Componentes:

  • Accede al Catálogo Maestro de 21st.dev en components-library/catalog/INDEX.md que contiene más de 11,750 componentes categorizados en 22 categorías (Botones, Héroes, Galerías, Características, Precios, Pies de Página, FAQs, etc.).

4. Servidor MCP Oficial de shadcn (Sin Clave API):

  • La IA utiliza el servidor shadcn MCP oficial (npx shadcn@latest mcp) que es 100% gratuito, de código abierto y no requiere ninguna clave API.
  • Cualquier componente del catálogo se puede instalar mediante:
    npx shadcn@latest add "https://21st.dev/r/<autor>/<nombre-del-componente>"
    
  • Nunca se requiere un MCP de 21st.dev de pago ni una clave API.

5. Inspiraciones de Plantillas Premium y Diseño de Movimiento:

La IA puede extraer activamente patrones arquitectónicos, movimiento cinético y diseños de alta conversión de los ecosistemas de diseño más premium del mundo:

  • VibeUI (vibeui.dev): Composiciones de componentes modernos, apilamientos de tarjetas táctiles, insignias interactivas, píldoras de control flotantes y primitivas de diseño estéticas.
  • Trical (trical.so): Plantillas de portafolio ultralimpias y de alta conversión, tipografía de calidad de revista, líneas divisorias sutiles y estudios de caso de proyectos editoriales.
  • Motion Site (motion.site.ai): Microanimaciones fluidas, revelaciones cinéticas de titulares, física de resorte y curvas de transición orgánicas.
  • 21st.dev y Aceternity UI: Catálogo maestro de más de 11,750 componentes compatibles con shadcn y primitivas de interacción espacial 3D.

⚡ Modos de Entrega Duales

La IA admite dos formatos de entrega flexibles según las necesidades del usuario:

Modo A: Código Base Completo React + Vite + Tailwind (TypeScript) (Predeterminado)

Genera una estructura de proyecto completa, modular y de nivel empresarial:

mi-portafolio/
├── package.json
├── vite.config.ts
├── tailwind.config.js
├── postcss.config.js
├── tsconfig.json
├── index.html
└── src/
    ├── main.tsx
    ├── App.tsx
    ├── index.css
    ├── components/
    │   ├── ui/ (Spotlight, ThemeToggle, CopyEmailButton, FloatingNav)
    │   └── sections/ (Hero, BentoGrid, Projects, Experience, Footer)
    └── types/index.ts

Modo B: Archivo HTML/Tailwind/Lucide/JS Único e Instantáneo

Cuando el usuario quiere cero configuración, vista previa inmediata en el navegador local o alojamiento instantáneo (ej. GitHub Pages):

  • Genera un único index.html autónomo, bellamente formateado.
  • Incluye CDN de Tailwind CSS, Google Fonts, CDN de Lucide Icons y JavaScript vanilla para el conmutador de tema, retroalimentación de copia, ventanas emergentes modales e interacciones al pasar el ratón.
  • Consulta las implementaciones de referencia en templates/developer-bento/index.html, templates/creative-minimalist/index.html y templates/video-editor-showreel/index.html.

🛠️ Flujo de Trabajo de Ejecución Paso a Paso

┌────────────────────────────────────────────────────────┐
│  PASO 1: RECEPCIÓN Y EXTRACCIÓN DEL CURRÍCULUM       │
│  Extraer métricas, roles, proyectos, stack tecnológico │
│  (O ejecutar cuestionario de 3 lotes de respaldo)      │
└───────────────────────────┬────────────────────────────┘
                            │
┌───────────────────────────▼────────────────────────────┐
│  PASO 2: ALINEACIÓN INTERACTIVA OBLIGATORIA            │
│  Preguntar: Estética, Modo de Tema, Héroe y Componentes │
└───────────────────────────┬────────────────────────────┘
                            │
┌───────────────────────────▼────────────────────────────┐
│  PASO 3: SELECCIÓN DE COMPONENTES Y ARQUITECTURA      │
│  Ensamblar primitivas de 21st.dev desde components-library/ │
└───────────────────────────┬────────────────────────────┘
                            │
┌───────────────────────────▼────────────────────────────┐
│  PASO 4: GENERACIÓN DE CÓDIGO DE PRODUCCIÓN           │
│  Generar React + Vite (predeterminado) o HTML autónomo │
└───────────────────────────┬────────────────────────────┘
                            │
┌───────────────────────────▼────────────────────────────┐
│  PASO 5: AUDITORÍA E INSTRUCCIONES DE EJECUCIÓN       │
│  Verificar reglas anti-slop, comprobar compilación,    │
│  proporcionar comandos                                  │
└────────────────────────────────────────────────────────┘

Paso 1: Protocolo de Recepción

  1. Si el usuario proporciona un currículum o resumen de LinkedIn: Analiza métricas reales, línea de tiempo profesional, los 3-4 proyectos principales y competencias técnicas.
  2. Si no se proporciona currículum: Nunca inventes credenciales. Ejecuta el cuestionario de 3 lotes desde references/questionnaire.md:
    • Lote 1: Identidad y Rol Objetivo
    • Lote 2: Los 2-3 Proyectos Principales y Números Concretos
    • Lote 3: Enlaces Sociales y de Contacto

Paso 2: Alineación Interactiva Obligatoria (NO SALTAR)

A menos que el usuario haya especificado explícitamente su estilo visual y componentes de antemano, pausa y presenta la alineación interactiva:

"Antes de generar tu portafolio, personalicemos el diseño visual y los componentes interactivos:

  1. Estilo Visual / Estética:
    • Tech Elegante / Bento Oscuro (Estilo Linear / 21st.dev — lienzo obsidiana, tarjetas con efecto spotlight al pasar el ratón, bordes finos).
    • Minimalista Limpio / Moderno Suizo (Estilo Dieter Rams / Apple — espacios en blanco generosos, tipografía refinada, líneas sutiles).
    • Editorial de Alto Contraste (Titulares serif, estética de estudio, estudios de caso tipo revista).
    • Creador Cinematográfico / Movimiento (Lienzo oscuro profundo, inserciones de reels de video enriquecidos, insignias de número de visualizaciones).
    • Neo-Brutalismo (...

[truncado para traducción - el documento continúa con el mismo patrón de localización para el resto del contenido]

Skills relacionados