Communitygithub.com

TasmiaZerin1128/TasmiaZerin1128.github.io

Crea sitios web de portafolio artísticos y animados con GSAP para ingenieros de software. Úsalo siempre que el usuario solicite un portafolio, página personal, sección 'Sobre mí', vitrina de proyectos o cualquier componente web de portafolio, especialmente si busca un estilo creativo, animado y visualmente distintivo que mantenga una identidad de desarrollador.

¿Qué es TasmiaZerin1128.github.io?

Esta habilidad está diseñada para construir portafolios web para ingenieros de software que se sientan como si hubieran sido creados por un estudio creativo, pero con el alma de un desarrollador. El objetivo no es un portafolio corporativo aburrido con una sección de héroe y tarjetas, sino una experiencia que haga que el visitante deje de desplazarse. Se basa en GSAP (GreenSock Animation Platform) para crear animaciones de alto impacto, como revelaciones escalonadas, animaciones de texto dividido, secciones fijas con desplazamiento (pin), efectos de paralaje, interacciones magnéticas y desplazamiento horizontal para vitrinas de proyectos. La habilidad incluye una filosofía de diseño que prioriza el drama intencional sobre el movimiento vacío, y ofrece cinco direcciones estéticas para elegir: Terminal Noir, Brutalist Code, Soft Engineering, Neon Architect y Analog Digital. También proporciona pautas detalladas sobre arquitectura de secciones, reglas tipográficas, paletas de colores, rendimiento, responsividad y accesibilidad, asegurando que el portafolio sea atractivo, rápido y usable en todos los dispositivos. La salida recomendada es un único archivo HTML con CSS y JS incrustados, a menos que el usuario especifique un framework.

Compatible con~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/TasmiaZerin1128/TasmiaZerin1128.github.io/tree/HEAD/.claude/skills

Preguntar en tu IA favorita

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

Documentación

Habilidad de Portafolio GSAP

Construye sitios web de portafolio que parezcan hechos por un estudio creativo, pero con el alma de un ingeniero de software. El objetivo nunca es un "portafolio corporativo con héroe y tarjetas". El objetivo es una experiencia que haga que alguien deje de desplazarse.

Filosofía

Los portafolios de desarrolladores fallan de dos maneras: o son aburridos (página blanca, cuadrícula de tarjetas, "Hola, soy un desarrollador") o se esfuerzan demasiado con efectos que se sienten desconectados del contenido. El punto óptimo es el drama intencional: cada animación debe sentirse como si estuviera revelando algo, no solo moviéndose por moverse.

Piensa en el portafolio como una narrativa, no como una página. El visitante está siendo guiado a través de una historia: quién eres → qué has construido → cómo piensas → cómo contactarte.

Integración GSAP

Siempre carga GSAP desde una CDN. Usa la última versión desde la CDN de GSAP (no cdnjs):

<script src="https://cdn.jsdelivr.net/npm/gsap@3/dist/gsap.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/gsap@3/dist/ScrollTrigger.min.js"></script>

Para proyectos React, instala mediante npm:

npm install gsap
import gsap from 'gsap';
import { ScrollTrigger } from 'gsap/ScrollTrigger';
gsap.registerPlugin(ScrollTrigger);

Patrones GSAP Básicos para Usar

1. Revelaciones Escalonadas: El pan de cada día. Nunca reveles un grupo de elementos de una sola vez.

gsap.from('.skill-item', {
  y: 60,
  opacity: 0,
  duration: 0.8,
  stagger: 0.12,
  ease: 'power3.out',
  scrollTrigger: {
    trigger: '.skills-section',
    start: 'top 80%',
  }
});

2. Animaciones de Texto Dividido: Divide los encabezados en caracteres/palabras y anímalos. Esta es la animación de mayor impacto que puedes agregar. Usa el plugin SplitText si está disponible, o divide manualmente con spans:

// División manual de caracteres
const heading = document.querySelector('.hero-title');
heading.innerHTML = heading.textContent.split('').map(
  (char, i) => `<span class="char" style="display:inline-block">${char === ' ' ? '&nbsp;' : char}</span>`
).join('');

gsap.from('.char', {
  y: 120,
  opacity: 0,
  rotateX: -80,
  stagger: 0.03,
  duration: 1,
  ease: 'power4.out',
});

3. Fijación por Desplazamiento: Fija secciones y anima el contenido dentro de ellas mientras el usuario se desplaza. Crea esa sensación "cinematográfica".

gsap.timeline({
  scrollTrigger: {
    trigger: '.pinned-section',
    start: 'top top',
    end: '+=200%',
    pin: true,
    scrub: 1,
  }
})
.from('.reveal-1', { xPercent: -100, opacity: 0 })
.from('.reveal-2', { yPercent: 50, opacity: 0 }, '-=0.3')
.from('.reveal-3', { scale: 0.8, opacity: 0 }, '-=0.3');

4. Capas de Paralaje: Dale profundidad con diferentes velocidades de desplazamiento.

gsap.to('.bg-layer', {
  yPercent: -30,
  ease: 'none',
  scrollTrigger: {
    trigger: '.parallax-section',
    start: 'top bottom',
    end: 'bottom top',
    scrub: true,
  }
});

5. Efectos Magnéticos / Seguimiento del Cursor: Para elementos interactivos como CTA o proyectos destacados.

const btn = document.querySelector('.magnetic-btn');
btn.addEventListener('mousemove', (e) => {
  const rect = btn.getBoundingClientRect();
  const x = e.clientX - rect.left - rect.width / 2;
  const y = e.clientY - rect.top - rect.height / 2;
  gsap.to(btn, { x: x * 0.3, y: y * 0.3, duration: 0.4, ease: 'power2.out' });
});
btn.addEventListener('mouseleave', () => {
  gsap.to(btn, { x: 0, y: 0, duration: 0.6, ease: 'elastic.out(1, 0.4)' });
});

6. Secciones de Desplazamiento Horizontal: Perfecto para vitrinas de proyectos. Te desplazas verticalmente pero el contenido se mueve horizontalmente.

const track = document.querySelector('.horizontal-track');
const items = gsap.utils.toArray('.project-card');

gsap.to(items, {
  xPercent: -100 * (items.length - 1),
  ease: 'none',
  scrollTrigger: {
    trigger: track,
    pin: true,
    scrub: 1,
    end: () => '+=' + track.scrollWidth,
  }
});

Lee references/gsap-patterns.md para patrones más avanzados como formas en morphing, estelas de cursor personalizadas, movimiento basado en ruido y sugerencias de integración WebGL.

Dirección Estética

Para el portafolio de un ingeniero de software, estas direcciones estéticas funcionan mejor. Elige una por proyecto — nunca las mezcles:

1. Terminal Noir

Fondo oscuro, tipografía monoespaciada combinada con una sans-serif definida, acentos verde/ámbar/cian sobre negro. Se siente como si estuvieras dentro de una terminal — pero una hermosa. Usa superposiciones de líneas de escaneo, cursores parpadeantes, animaciones de escritura. Piensa: estética hacker con diseño editorial.

2. Brutalist Code

Estructura cruda y expuesta. Cuadrículas visibles, tipografía mono grande, contraste agresivo. Los elementos parecen colocados con position: absolute a propósito. Las animaciones son rápidas y mecánicas — sin ease-out, usa steps() o power4.inOut. Piensa: si un compilador tuviera buen gusto.

3. Soft Engineering

Fondos claros con neutros cálidos, espacios en blanco generosos, serifa elegante para encabezados combinada con una sans-serif limpia. Animaciones suaves y fluidas. Se siente premium y tranquilo. Piensa: si Dieter Rams diseñara un portafolio.

4. Neon Architect

Base oscura, acentos neón vibrantes (magenta, azul eléctrico, lima), glassmorphism, efectos de brillo. Animaciones fluidas y casi líquidas. Diseño basado en cuadrícula con elementos superpuestos. Piensa: Blade Runner se encuentra con el diseño suizo.

5. Analog Digital

Texturas de papel, elementos dibujados a mano combinados con tipografía digital definida, superposiciones sutiles de grano. Paleta de colores cálidos. Las animaciones imitan el movimiento físico: las cosas se deslizan como papel, se apilan como tarjetas. Piensa: un desarrollador que también dibuja.

Arquitectura de Secciones

Un portafolio sólido sigue esta estructura. Cada sección debe sentirse como su propia "escena":

Héroe

Los primeros 3 segundos son los más importantes. Comienza con animación de texto: el visitante debe verte cobrar vida. Incluye una animación ambiental sutil en el fondo (partículas flotantes, formas morphing, animación de degradado). Mantén el mensaje simple: Nombre + identidad en una línea.

Sobre Mí / Filosofía

No solo enumeres hechos. Expresa una visión del mundo. Usa una revelación por desplazamiento para mostrar el texto línea por línea. Una foto es opcional, pero si se incluye, usa un tratamiento creativo (duotono, revelación con clip-path, desplazamiento de paralaje).

Habilidades / Stack Tecnológico

NUNCA uses una cuadrícula aburrida de logotipos. En su lugar, prueba: una visualización orbital, un ticker/marquee con desplazamiento, etiquetas interactivas que reaccionan al hover, un mapa de constelaciones, o una lista estilo terminal que se "escribe" a sí misma.

Proyectos

La pieza central. Cada proyecto necesita espacio para respirar. Usa: galería de desplazamiento horizontal, tarjetas apiladas a pantalla completa que se fijan y transicionan, o tarjetas expandibles con revelaciones por desplazamiento. Cada proyecto debe mostrar: título, descripción breve, tecnologías usadas y un visual (captura de pantalla, video o ilustración creativa).

Contacto / Pie de Página

Termina con intención. Un gran CTA tipográfico, quizás un saludo basado en la hora ("Buenas noches — hablemos"), y enlaces de contacto limpios. Que sea contundente.

Lee references/portfolio-sections.md para plantillas detalladas de HTML/CSS/JS para cada tipo de sección.

Reglas Tipográficas

Importa fuentes desde Google Fonts. Nunca uses fuentes del sistema ni Inter/Roboto.

Buenas combinaciones para portafolios de desarrolladores:

  • Display + Body: "Clash Display" + "Satoshi" (vía fontshare.com CDN)
  • Display + Body: "Syne" + "Work Sans" (Google Fonts)
  • Display + Body: "Space Grotesk" + "DM Sans" (Google Fonts) — solo si buscas un vibe tecnológico
  • Mono + Sans: "JetBrains Mono" + "General Sans" (fontshare) — para estética terminal
  • Serif + Sans: "Playfair Display" + "Source Sans 3" — para la dirección suave/premium
  • Display + Body: "Anybody" + "Instrument Sans" (Google Fonts)
  • Display + Body: "Bricolage Grotesque" + "Geist" (vía CDN)

Carga mediante:

<link href="https://api.fontshare.com/v2/css?f[]=clash-display@400,500,600,700&f[]=satoshi@400,500,700&display=swap" rel="stylesheet">

o

<link href="https://fonts.googleapis.com/css2?family=Syne:wght@400;500;600;700;800&family=Work+Sans:wght@300;400;500;600&display=swap" rel="stylesheet">

Reglas de Color

Define una paleta usando propiedades personalizadas de CSS. Cada paleta necesita:

  • --bg: fondo principal
  • --fg: texto principal
  • --accent: color de acento primario
  • --accent-2: acento secundario (opcional)
  • --muted: texto atenuado / bordes
  • --surface: fondos de tarjetas/secciones

Ejemplo (Terminal Noir):

:root {
  --bg: #0a0a0a;
  --fg: #e8e8e8;
  --accent: #00ff88;
  --accent-2: #0088ff;
  --muted: #333;
  --surface: #111;
}

Ejemplo (Soft Engineering):

:root {
  --bg: #f8f5f0;
  --fg: #1a1a1a;
  --accent: #c45d3e;
  --accent-2: #2d5a7b;
  --muted: #b8b0a4;
  --surface: #ffffff;
}

Reglas de Rendimiento

GSAP es eficiente por defecto, pero sigue estas:

  • Usa will-change: transform en elementos animados
  • Prefiere transform y opacity sobre propiedades de layout (width, height, top, left)
  • Usa ScrollTrigger.batch() para muchos elementos similares en lugar de activadores individuales
  • Agrega loading="lazy" a las imágenes debajo del pliegue
  • Mantén el peso total de la página por debajo de 2MB (excluyendo videos)
  • Usa gsap.matchMedia() para deshabilitar animaciones pesadas en móvil:
gsap.matchMedia().add('(max-width: 768px)', () => {
  // Animaciones móviles más simples aquí
});

Responsividad

Cada sección debe funcionar en móvil. Reglas clave:

  • Tamaños de fuente: usa clamp() para escalado fluido — ej., clamp(2rem, 5vw, 5rem)
  • Las secciones de desplazamiento horizontal deben convertirse en apilamiento vertical en móvil
  • Secciones fijas: reduce la duración de fijación o elimínala en móvil mediante gsap.matchMedia()
  • Objetos táctiles: botones/enlaces de al menos 44px
  • Prueba en los puntos de quiebre 375px, 768px, 1440px

Accesibilidad

Los portafolios animados aún deben ser accesibles:

  • Respeta prefers-reduced-motion:
const prefersReduced = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
if (prefersReduced) {
  gsap.globalTimeline.timeScale(0); // o salta las animaciones por completo
}
  • HTML semántico: usa <main>, <section>, <nav>, <header>, <footer>
  • Texto alternativo en todas las imágenes
  • Elementos interactivos navegables por teclado
  • Contraste de color suficiente (4.5:1 mínimo para texto del cuerpo)

Al Construir

  1. Comienza con la dirección estética — confírmala con el usuario o elige basándote en su estilo
  2. Construye la estructura HTML con secciones semánticas
  3. Aplica estilo con CSS (propiedades personalizadas, tipografía fluida, grid/flexbox)
  4. Agrega animaciones GSAP sección por sección
  5. Añade ScrollTrigger para revelaciones por desplazamiento
  6. Agrega interactividad (estados hover, efectos de cursor, micro-interacciones)
  7. Hazlo responsivo
  8. Agrega manejo de prefers-reduced-motion
  9. Optimiza (carga diferida, will-change, matchMedia para móvil)

Siempre genera un único archivo HTML con CSS y JS incrustados a menos que el usuario especifique un framework.

Skills relacionados