Communitygithub.com

Portfolio personal greenfield — sitio GSAP en un prompt

Genera un portfolio personal desplegable con un solo prompt: HTML/CSS/JS + GSAP vanilla, cero build, 5 temas, 12 tipografías, 16 reglas anti-AI-slop y 8+ patrones de motion. Abre index.html y funciona.

¿Qué es Portfolio personal greenfield — sitio GSAP en un prompt?

Personal websites paso 1 (scaffold): Mort1d portfolio-genesis. Un prompt → sitio personal vanilla completo con temas, tipografía, GSAP y anti-slop.

Compatible con~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Mort1d/portfolio-site/tree/HEAD/skill/portfolio-genesis

Preguntar en tu IA favorita

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

Documentación

Génesis de Portafolio

Generador de portafolios con un solo prompt. Produce sitios completos y desplegables con animaciones GSAP profesionales, diseño responsivo y estéticas distintivas que parecen hechas a mano — no generadas por IA. El usuario abre index.html en el navegador y ve un portafolio de calidad profesional.

Filosofía

  • Cada portafolio cuenta una historia. El diseño ES el primer proyecto del portafolio.
  • Anti-plantilla: no hay dos sitios generados que se vean iguales. El tema se basa en el campo, la personalidad y el tono del usuario.
  • "Abre index.html y di GUAU" — cero npm, cero pasos de compilación, gratificación instantánea.
  • Restricción = libertad: HTML/CSS/JS vanilla + GSAP fuerza un CSS creativo que se siente hecho a mano.
  • Un portafolio con 3 proyectos bien presentados supera a 20 tarjetas genéricas. Calidad sobre cantidad.
  • La experiencia de desplazamiento ES el portafolio. Cada píxel desplazado debe sentirse intencional.

Proceso

Paso 1: Recopilación

Extraer del prompt del usuario:

  • Identidad: nombre, usuario/alias, rol/título
  • Biografía: 1-3 oraciones (sintetizar del contexto si no se proporciona)
  • Proyectos: título, descripción, etiquetas, enlaces, montos de acuerdos, rol
  • Redes sociales: X, Discord, Telegram, GitHub, LinkedIn, email, YouTube (solo incluir las proporcionadas)
  • Avatar: ruta de archivo o generar círculo CSS degradado con iniciales
  • Estadísticas: años de experiencia, cantidad de proyectos, alcance comunitario, herramientas exploradas
  • Tono: profesional | hacker | creativo | elegante | juguetón | minimalista | cibernético

Si el usuario proporciona información mínima, generar con datos contextualmente relevantes de marcador de posición y marcar puntos de inyección: <!-- CUSTOMIZE: Reemplaza con tu usuario de Twitter -->. Omitir botones sociales por completo si no se proporciona ninguna URL — nunca renderizar href="#".

Paso 2: Selección de Tema

Usar el árbol de decisiones a continuación para seleccionar entre 5 temas. Luego leer el archivo del tema desde references/themes/{nombre-del-tema}.md.

¿El usuario está en crypto/web3/blockchain?
  SÍ → ¿"limpio"/"minimalista" mencionado? → mono-minimal
        De lo contrario → midnight-glass (por defecto) o neon-cyberpunk (si "neón"/"cibernético" mencionado)

¿El usuario es diseñador/artista/creativo?
  SÍ → ¿Prefiere oscuro? → midnight-glass
        De lo contrario → warm-organic (por defecto) o paper-brutalist (si "editorial"/"impreso")

¿El usuario es desarrollador/ingeniero?
  SÍ → midnight-glass (por defecto) o mono-minimal (si "limpio"/"minimalista")

¿El usuario es estudiante/principiante?
  SÍ → warm-organic (amigable) o neon-cyberpunk (si joven/energético)

¿El usuario es empresario/profesional?
  SÍ → mono-minimal (por defecto) o warm-organic (si "accesible")

Anulaciones explícitas (máxima prioridad):
  "oscuro" / "cristal" → midnight-glass
  "claro" / "limpio" / "papel" → paper-brutalist
  "neón" / "cibernético" / "futurista" → neon-cyberpunk
  "cálido" / "terroso" / "orgánico" → warm-organic
  "minimalista" / "mono" / "tipografía" → mono-minimal

Paso 3: Generar Archivos

Leer los archivos de referencia en este orden:

  1. references/themes/{tema-seleccionado}.md — colores, fuentes, estilo de tarjeta
  2. references/animations/gsap-patterns.md — recetas de animación
  3. references/sections/hero-variants.md — elegir diseño de héroe
  4. references/typography/font-pairings.md — confirmar elección de fuente

Generar exactamente 3 archivos: index.html, css/style.css, js/main.jsre

Decisión de Diseño de Héroe

¿Imagen de avatar proporcionada?
  SÍ → Avatar centrado (por defecto)
        Excepción: diseñador con muestra de proyecto sólida → Héroe dividido
  NO  → ¿Título/eslogan fuerte? → Tipografía de pantalla completa
        De lo contrario → Minimalista (nombre + rol + indicador de desplazamiento)

Cantidad de descriptores de rol:
  1   → Subtítulo grande único
  2-3 → Línea de subtítulo separada por puntos
  4+  → Rotación de roles animada mediante intercambio de texto GSAP

Decisión de Sección de Proyectos

Cantidad de proyectos:
  0   → Omitir proyectos. Agregar sección de nube de etiquetas de Habilidades/Tecnología
  1-2 → Tarjetas destacadas grandes (ancho completo o 2 columnas con relleno extra)
  3-4 → Cuadrícula de 2 columnas con tamaño igual
  5-8 → Cuadrícula Bento (1 grande + tarjetas más pequeñas)
  9+  → Mostrar los 6 principales con enlace "Ver todo", o desplazamiento horizontal

Paso 4: Control de Calidad

Ejecutar la lista de verificación previa a la entrega antes de generar los archivos.

Estructura de Salida

index.html

HTML5 semántico completo. Enlaces CDN para Google Fonts y GSAP 3.12.5. Todo el contenido en línea. Secciones: navegación, héroe, acerca, proyectos (si aplica), marquesina/habilidades opcional, contacto, pie de página. Incluye:

  • <!DOCTYPE html>, <html lang="en">, charset, viewport
  • <title> con nombre de usuario + rol
  • <meta name="description"> con biografía
  • Etiquetas OG: og:title, og:description, og:type (website)
  • Google Fonts <link rel="preconnect"> + hoja de estilo
  • GSAP + ScrollTrigger CDN con defer
  • <link rel="stylesheet" href="css/style.css">
  • <script src="js/main.js" defer> al final del body

css/style.css

Todos los estilos. Propiedades personalizadas CSS en :root (mínimo 20 variables que cubren colores, fuentes, espaciado, radio, easing). Totalmente responsivo (768px + 480px breakpoints). Debe incluir:

  • Reinicio: *, *::before, *::after { margin:0; padding:0; box-sizing:border-box }
  • html { scroll-behavior: smooth } + barra de desplazamiento personalizada
  • body { overflow-x: hidden; -webkit-font-smoothing: antialiased }
  • ::selection con acento del tema
  • Superposición de ruido (feTurbulence SVG en línea, opacidad 0.02-0.04)
  • .reveal-up { opacity: 0; transform: translateY(30px) } estado inicial
  • @media (prefers-reduced-motion: reduce) — deshabilitar todas las animaciones, ocultar brillo del cursor
  • Cada elemento decorativo fijo/absoluto: pointer-events: none

js/main.js

Animaciones GSAP envueltas en DOMContentLoaded. Comienza con verificación de disponibilidad de GSAP:

if (typeof gsap === 'undefined') {
    document.querySelectorAll('.reveal-up').forEach(el => {
        el.style.opacity = '1';
        el.style.transform = 'none';
    });
    return;
}

Registra ScrollTrigger. Contiene: línea de tiempo de entrada al héroe, revelaciones al desplazarse, contadores de estadísticas, inclinación de tarjetas, brillo del cursor, botones magnéticos, paralaje, reducción de navegación. Leer references/animations/gsap-patterns.md para implementaciones exactas.

Puntos de Personalización

UbicaciónFuente de DatosAlternativa
<title>Nombre + rol"Portafolio"
<meta description>Rol + habilidadesGenerado a partir del rol
Etiquetas OGIgual que título/descIgual
Logo de navegaciónUsuario entre corchetes [MX]Iniciales
H1 de héroeRol o declaración de identidadCampo + "Constructor"
Subtítulo de héroeRoles separados por ·3 áreas de habilidad
Insignia de héroe@usuario"@username"
Avatar src + altRuta del usuarioCírculo CSS degradado con iniciales
Botones socialesSolo URLs realesOmitir botón si no hay URL
Encabezado de AcercaDeclaración personal"Construyendo en la intersección de X, Y & Z"
Biografía de AcercaProporcionado por usuario o sintetizadoBiografía de 3 oraciones
EtiquetasÁreas de habilidadDel rol/proyectos
Tarjetas de estadísticasNúmeros reales + etiquetasEstimaciones del contexto
Tarjetas de proyectoTítulo, desc, etiquetas, enlacesDe información del proyecto
Tarjetas de contactoPlataforma, usuario, URLSolo plataformas proporcionadas
Pie de páginaNombre + new Date().getFullYear()Año dinámico mediante JS

Anti-patrones

#Anti-patrónPor qué FallaHacer en su Lugar
1Inter/Roboto como fuente de encabezadoSeñala instantáneamente "generado por IA". Son fuentes de cuerpo, no fuentes de exhibición.Usar fuentes de exhibición distintivas: Syne, Outfit, Instrument Serif, Bricolage Grotesque, Unbounded
2Degradado púrpura sobre blancoEl cliché visual #1 de "basura de IA" desde 2023. Todos lo reconocen.Fondos oscuros con acentos vívidos, o paletas cálidas.
3Space Grotesk como predeterminadoEra distintivo en 2023, ahora la fuente más sobreutilizada en sitios generados por IA.Rotar entre 12 combinaciones seleccionadas. Usar solo si el usuario lo marca explícitamente.
4opacity:0 sin alternativa de GSAPSi el CDN de GSAP falla, todo el sitio es invisible. Página en blanco.Primera línea de JS: verificar typeof gsap, si no está definido poner todos los .reveal-up visibles.
5Gran héroe, genérico abajo del pliegueEl "guau" muere al desplazarse. Tarjetas de molde debajo de un héroe cinematográfico.Cada sección recibe igual atención de diseño. El viaje de desplazamiento ES el portafolio.
6href="#" en enlaces socialesHace que el sitio sea obviamente falso. Mata la credibilidad.Usar URLs reales. Si no se proporciona ninguna, omitir el botón por completo.
7Misma temporización de animación en todas partesTodo a la misma velocidad y con el mismo easing se siente robótico.Variar duraciones (0.4s-1.2s). Diferentes easings por elemento. Escalonar con desplazamientos negativos.
8Elementos decorativos sin pointer-events: noneOrbes, ruido, brillo del cursor bloquean los clics del mouse en el contenido debajo.Cada elemento decorativo fijo/absoluto recibe pointer-events: none.
9Texto degradado sobre fondo degradadoIlegible. Dos degradados en competencia se cancelan mutuamente.Texto degradado solo en fondos oscuros sólidos/casi sólidos. Un degradado por área visual.
10Falta cursor: pointer en tarjetasLa tarjeta parece interactiva pero el cursor permanece predeterminado. Usuario confundido.cursor: pointer en cada elemento con estado hover o controlador de clic.
11Iconos emoji en la interfaz de usuarioSeñal universal de "hecho por IA". Sin esfuerzo de diseño.SVG en línea desde assets/social-icons.svg. Sin emoji en navegación, botones, encabezados.
12width: 100vwEn Windows con barra de desplazamiento, incluye el ancho de la barra → desbordamiento horizontal.Usar width: 100% o overflow-x: hidden en el body.
13Cargar biblioteca de iconos para 5 iconosSolicitud HTTP adicional, FOUC, dependencia de CDN para ~2KB de rutas SVG.SVG en línea directamente en HTML. 5-8 iconos sociales = ~2KB en línea.
14Texto de CTA genérico"Conectémonos" / "Ponte en Contacto" — todos los portafolios de IA usan estos.Coincidir con la personalidad: "Construyamos Algo" (constructor), "Di gm" (crypto), "Deja una Línea" (informal).
15Falta alt en avatarFalla accesibilidad. Los lectores de pantalla no anuncian nada.alt="[Nombre del usuario]" — simple, descriptivo.
16Texto degradado arcoíris de 4+ coloresParece un juguete. Los degradados multicolores rara vez funcionan.Máximo 2-3 colores de la misma familia (rosa → púrpura, no rosa → verde → azul).

Animaciones Requeridas

Leer references/animations/gsap-patterns.md para implementaciones. Cada sitio debe incluir:

  1. Línea de tiempo de entrada al héroe — .from() escalonados: avatar (back.out), insignia, líneas de título, subtítulo, redes sociales (back.out escalonado), indicador de desplazamiento. Superpuestos con desplazamientos negativos.
  2. Revelaciones al desplazarse — elementos .reveal-up animan desde {y:30, opacity:0} en start: "top 85%". Escalonar dentro de grupos del viewport.
  3. Contadores de estadísticas — animar de 0 a objetivo mediante onUpdate. Activados al desplazarse.
  4. Inclinación de tarjetas — mousemove → rotateX/rotateY desde el desplazamiento del cursor. transformPerspective: 1000. Reiniciar al salir del mouse.
  5. Brillo del cursor — degradado radial de 600px sigue al mouse con requestAnimationFrame + 0.08 lerp.
  6. Botones magnéticos — los botones sociales se mueven hacia el cursor (factor 0.3x), regresan con elastic.out(1, 0.5).
  7. Fondo de paralaje — elementos decorativos se mueven al desplazarse con scrub: 1.
  8. Reducción de navegación — alternar clase .scrolled a 80px de profundidad de desplazamiento.

Opcional (agregar según tema/contenido):

  • Marquee con aumento de velocidad de desplazamiento
  • Revelación de texto letra por letra (ciberpunk/dramático)
  • Desplazamiento horizontal para 5+ proyectos
  • Brillo de texto degradado al hover
  • Deslizamiento de etiqueta de sección desde la izquierda

Lista de Verificación de Calidad

Estructural:

  • Los 3 archivos generados (index.html, css/style.css, js/main.js)
  • DOCTYPE, charset, viewport, atributo lang presentes
  • Metaetiquetas OG con información real del usuario
  • Todas las propiedades personalizadas CSS en :root
  • Enlaces CDN de GSAP con defer
  • JS vinculado al final del body con defer

Contenido:

  • Todos los datos del usuario inyectados (nombre, enlaces, proyectos, biografía)
  • Sin marcadores de posición genéricos ("Lorem ipsum", "Tu Nombre Aquí")
  • Los enlaces sociales usan URLs reales, sin href="#" para enlaces proporcionados
  • Pie de página tiene nombre correcto y año dinámico

Visual:

  • La combinación de fuentes NO es Inter, Roboto, Arial o Space Grotesk (a menos que el usuario lo especifique)
  • Sin esquema de color púrpura sobre blanco
  • Sin iconos emoji en la interfaz de usuario
  • Contraste de color cumple WCAG AA (4.5:1 para texto del cuerpo)
  • Responsivo en 375px, 768px, 1440px — sin desplazamiento horizontal
  • prefers-reduced-motion deshabilita animaciones y oculta el brillo del cursor

Técnico:

  • Alternativa de GSAP presente (verificación typeof + reinicio de opacidad)
  • Todos los elementos decorativos tienen pointer-events: none
  • Sin width: 100vw en CSS
  • Todos los elementos interactivos tienen cursor: pointer
  • Las imágenes tienen atributos alt
  • Los enlaces externos tienen target="_blank" rel="noopener"

Skills relacionados