Communitygithub.com

SamuelChien/mega-skills-collection

Experto en crear experiencias 3D para la web - Three.js, React Three Fiber, Spline, WebGL y escenas 3D interactivas. Cubre configuradores de productos, portafolios 3D, sitios web inmersivos y dar profundidad a las experiencias web.

¿Qué es mega-skills-collection?

Esta habilidad te convierte en un arquitecto de experiencias 3D para la web, capacitándote para decidir cuándo el 3D realmente mejora la experiencia y cuándo es solo ostentación. Dominas tecnologías clave como Three.js, React Three Fiber, Spline, WebGL y shaders GLSL, así como la optimización de modelos 3D para la web. La habilidad proporciona guías detalladas para seleccionar la pila 3D adecuada (Spline, R3F o Three.js vanilla), preparar modelos 3D para producción (con pipelines de optimización y compresión GLTF), e implementar efectos de desplazamiento (scroll-driven 3D) usando R3F o GSAP. También incluye estrategias críticas de rendimiento como detección de dispositivos móviles, limitación de DPR, uso de LOD (nivel de detalle) y fallbacks para navegadores sin soporte WebGL, todo ello esencial para mantener la fluidez en diferentes dispositivos.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SamuelChien/mega-skills-collection/tree/HEAD/3d-web-experience

Preguntar en tu IA favorita

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

Vista previa

Del README del skill

mega-skills-collection preview

Documentación

Experiencia Web 3D

Experto en crear experiencias 3D para la web - Three.js, React Three Fiber, Spline, WebGL y escenas 3D interactivas. Cubre configuradores de productos, portafolios 3D, sitios web inmersivos y dar profundidad a las experiencias web.

Rol: Arquitecto de Experiencias Web 3D

Traes la tercera dimensión a la web. Sabes cuándo el 3D realza la experiencia y cuándo solo es exhibicionismo. Equilibras el impacto visual con el rendimiento. Haces que el 3D sea accesible para usuarios que nunca han usado una aplicación 3D. Creas momentos de asombro sin sacrificar la usabilidad.

Experiencia

  • Three.js
  • React Three Fiber
  • Spline
  • WebGL
  • Shaders GLSL
  • Optimización 3D
  • Preparación de modelos

Capacidades

  • Implementación con Three.js
  • React Three Fiber
  • Optimización WebGL
  • Integración de modelos 3D
  • Flujos de trabajo con Spline
  • Configuradores de productos 3D
  • Escenas 3D interactivas
  • Optimización del rendimiento 3D

Patrones

Selección de la Pila 3D

Elegir el enfoque 3D adecuado

Cuándo usarlo: Al comenzar un proyecto web 3D

Selección de la Pila 3D

Comparación de Opciones

HerramientaMejor ParaCurva de AprendizajeControl
SplinePrototipos rápidos, diseñadoresBajaMedio
React Three FiberApps React, escenas complejasMediaAlto
Three.js vanillaMáximo control, no ReactAltaMáximo
Babylon.jsJuegos, 3D pesadoAltaMáximo

Árbol de Decisión

¿Necesitas un elemento 3D rápido?
└── Sí → Spline
└── No → Continuar

¿Usas React?
└── Sí → React Three Fiber
└── No → Continuar

¿Necesitas máximo rendimiento/control?
└── Sí → Three.js vanilla
└── No → Spline o R3F

Spline (Inicio más Rápido)

import Spline from '@splinetool/react-spline';

export default function Scene() {
  return (
    <Spline scene="https://prod.spline.design/xxx/scene.splinecode" />
  );
}

React Three Fiber

import { Canvas } from '@react-three/fiber';
import { OrbitControls, useGLTF } from '@react-three/drei';

function Model() {
  const { scene } = useGLTF('/model.glb');
  return <primitive object={scene} />;
}

export default function Scene() {
  return (
    <Canvas>
      <ambientLight />
      <Model />
      <OrbitControls />
    </Canvas>
  );
}

Pipeline de Modelos 3D

Preparar modelos para la web

Cuándo usarlo: Al preparar activos 3D

Pipeline de Modelos 3D

Selección de Formato

FormatoCaso de UsoTamaño
GLB/GLTFWeb 3D estándarMás pequeño
FBXDesde software 3DGrande
OBJMallas simplesMediano
USDZApple ARMediano

Pipeline de Optimización

1. Modelar en Blender/etc
2. Reducir conteo de polígonos (< 100K para web)
3. Hornear texturas (combinar materiales)
4. Exportar como GLB
5. Comprimir con gltf-transform
6. Verificar tamaño del archivo (< 5MB ideal)

Compresión GLTF

# Instalar gltf-transform
npm install -g @gltf-transform/cli

# Comprimir modelo
gltf-transform optimize input.glb output.glb \
  --compress draco \
  --texture-compress webp

Carga en R3F

import { useGLTF, useProgress, Html } from '@react-three/drei';
import { Suspense } from 'react';

function Loader() {
  const { progress } = useProgress();
  return <Html center>{progress.toFixed(0)}%</Html>;
}

export default function Scene() {
  return (
    <Canvas>
      <Suspense fallback={<Loader />}>
        <Model />
      </Suspense>
    </Canvas>
  );
}

3D con Desplazamiento (Scroll-Driven 3D)

3D que responde al desplazamiento

Cuándo usarlo: Al integrar 3D con el desplazamiento

3D con Desplazamiento

R3F + Controles de Desplazamiento

import { ScrollControls, useScroll } from '@react-three/drei';
import { useFrame } from '@react-three/fiber';

function RotatingModel() {
  const scroll = useScroll();
  const ref = useRef();

  useFrame(() => {
    // Rotar según la posición del desplazamiento
    ref.current.rotation.y = scroll.offset * Math.PI * 2;
  });

  return <mesh ref={ref}>...</mesh>;
}

export default function Scene() {
  return (
    <Canvas>
      <ScrollControls pages={3}>
        <RotatingModel />
      </ScrollControls>
    </Canvas>
  );
}

GSAP + Three.js

import gsap from 'gsap';
import ScrollTrigger from 'gsap/ScrollTrigger';

gsap.to(camera.position, {
  scrollTrigger: {
    trigger: '.section',
    scrub: true,
  },
  z: 5,
  y: 2,
});

Efectos Comunes de Desplazamiento

  • Movimiento de cámara a través de la escena
  • Rotación de modelo al desplazarse
  • Revelar/ocultar elementos
  • Cambios de color/material
  • Animaciones de vista explosionada

Optimización del Rendimiento

Mantener el 3D rápido

Cuándo usarlo: Siempre - el 3D es costoso

Rendimiento 3D

Objetivos de Rendimiento

DispositivoFPS ObjetivoTriángulos Máximos
Escritorio60fps500K
Móvil30-60fps100K
Gama baja30fps50K

Soluciones Rápidas

// 1. Usar instancias para objetos repetidos
import { Instances, Instance } from '@react-three/drei';

// 2. Limitar luces
<ambientLight intensity={0.5} />
<directionalLight /> // Solo una

// 3. Usar LOD (Nivel de Detalle)
import { LOD } from 'three';

// 4. Carga diferida de modelos
const Model = lazy(() => import('./Model'));

Detección Móvil

const isMobile = /iPhone|iPad|Android/i.test(navigator.userAgent);

<Canvas
  dpr={isMobile ? 1 : 2} // Menor resolución en móvil
  performance={{ min: 0.5 }} // Permitir caídas de frames
>

Estrategia de Respaldo

function Scene() {
  const [webGLSupported, setWebGLSupported] = useState(true);

  if (!webGLSupported) {
    return <img src="/fallback.png" alt="Vista previa 3D" />;
  }

  return <Canvas onCreated={...} />;
}

Validaciones

Sin Indicador de Carga 3D

Severidad: ALTA

Mensaje: No hay indicador de carga para contenido 3D.

Acción correctiva: Añadir Suspense con fallback de carga o useProgress para la UI de carga

Sin Respaldo para WebGL

Severidad: MEDIA

Mensaje: No hay respaldo para dispositivos sin soporte WebGL.

Acción correctiva: Añadir detección de WebGL y una imagen de respaldo estática

Modelos 3D Sin Comprimir

Severidad: MEDIA

Mensaje: Los modelos 3D pueden no estar optimizados.

Acción correctiva: Comprimir modelos con gltf-transform usando compresión Draco y de texturas

OrbitControls Bloqueando Desplazamiento

Severidad: MEDIA

Mensaje: OrbitControls puede estar capturando eventos de desplazamiento.

Acción correctiva: Añadir enableZoom={false} o manejar los eventos de desplazamiento/toque adecuadamente

DPR Alto en Móvil

Severidad: MEDIA

Mensaje: El DPR del Canvas puede ser demasiado alto para dispositivos móviles.

Acción correctiva: Limitar el DPR a 1 en dispositivos móviles para mejor rendimiento

Colaboración

Disparadores de Delegación

  • scroll animation|parallax|GSAP -> scroll-experience (Integración de desplazamiento)
  • react|next|frontend -> frontend (Integración React)
  • performance|slow|fps -> performance-hunter (Optimización de rendimiento 3D)
  • product page|landing|marketing -> landing-page-design (Página de producto con 3D)

Configurador de Productos

Habilidades: 3d-web-experience, frontend, landing-page-design

Flujo de trabajo:

1. Preparar modelo 3D del producto
2. Configurar escena React Three Fiber
3. Añadir interactividad (colores, variantes)
4. Integrar con la página del producto
5. Optimizar para móvil
6. Añadir imágenes de respaldo

Portafolio Inmersivo

Habilidades: 3d-web-experience, scroll-experience, interactive-portfolio

Flujo de trabajo:

1. Diseñar el concepto de la escena 3D
2. Construir la escena en Spline o R3F
3. Añadir animaciones impulsadas por desplazamiento
4. Integrar con secciones del portafolio
5. Asegurar respaldo para móvil
6. Optimizar el rendimiento

Habilidades Relacionadas

Funciona bien con: scroll-experience, interactive-portfolio, frontend, landing-page-design

Cuándo Usar

  • El usuario menciona o implica: sitio web 3D
  • El usuario menciona o implica: three.js
  • El usuario menciona o implica: WebGL
  • El usuario menciona o implica: react three fiber
  • El usuario menciona o implica: experiencia 3D
  • El usuario menciona o implica: spline
  • El usuario menciona o implica: configurador de productos

Limitaciones

  • Usa esta habilidad solo cuando la tarea coincida claramente con el alcance descrito anteriormente.
  • No trates la salida como un sustituto de la validación específica del entorno, pruebas o revisión experta.
  • Detente y pide aclaraciones si faltan entradas requeridas, permisos, límites de seguridad o criterios de éxito.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

SamuelChien/mega-skills-collection

Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

SamuelChien/mega-skills-collection

Arquitecto de Soluciones Principal y Consultor Tecnológico de Andru.ia. Diagnostica y traza la hoja de ruta óptima para proyectos de IA en español.

SamuelChien/mega-skills-collection

Ingeniero de Sistemas de Andru.ia. Diseña, redacta y despliega nuevas habilidades (skills) dentro del repositorio siguiendo el Estándar de Diamante.

SamuelChien/mega-skills-collection

Estratega de Inteligencia de Dominio de Andru.ia. Analiza el nicho específico de un proyecto para inyectar conocimientos, regulaciones y estándares únicos del sector. Actívalo tras definir el nicho.

SamuelChien/mega-skills-collection

2D game development principles. Sprites, tilemaps, physics, camera.

SamuelChien/mega-skills-collection

3D game development principles. Rendering, shaders, physics, cameras.

SamuelChien/mega-skills-collection

Accessibility audit skill for scanning, fixing, and verifying WCAG 2.2 Level A and AA compliance across React, Next.js, Vue, Angular, Svelte, and plain HTML codebases. Use when auditing accessibility, fixing a11y violations, checking color contrast, generating compliance reports, or integrating accessibility checks into CI/CD pipelines.

SamuelChien/mega-skills-collection

Ab Test Analyzer - Auto-activating skill for Data Analytics. Triggers on: ab test analyzer, ab test analyzer Part of the Data Analytics skill category.

SamuelChien/mega-skills-collection

A B Test Config Creator - Auto-activating skill for ML Deployment. Triggers on: a b test config creator, a b test config creator Part of the ML Deployment skill category.

SamuelChien/mega-skills-collection

When the user wants to plan, design, or implement an A/B test or experiment. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "conversion experiment," "statistical significance," or "test this." For tracking implementation, see analytics-tracking.

SamuelChien/mega-skills-collection

Acceptance Criteria Creator - Auto-activating skill for Enterprise Workflows. Triggers on: acceptance criteria creator, acceptance criteria creator Part of the Enterprise Workflows skill category.

SamuelChien/mega-skills-collection

Use when a coding task should be driven end-to-end from issue intake through implementation, review, deployment, and acceptance verification with minimal human re-intervention.

SamuelChien/mega-skills-collection

Accessibility Audit Runner - Auto-activating skill for Frontend Development. Triggers on: accessibility audit runner, accessibility audit runner Part of the Frontend Development skill category.

SamuelChien/mega-skills-collection

You are an accessibility expert specializing in WCAG compliance, inclusive design, and assistive technology compatibility. Conduct audits, identify barriers, and provide remediation guidance.

SamuelChien/mega-skills-collection

Web accessibility patterns for WCAG 2.2 compliance including ARIA, keyboard navigation, screen readers, and testing

SamuelChien/mega-skills-collection

Manage Discord channel access — approve pairings, edit allowlists, set DM/group policy. Use when the user asks to pair, approve someone, check who's allowed, or change policy for the Discord channel.

SamuelChien/mega-skills-collection

Create unified specification packages across Business, Development, and Design teams. Staged elaboration (L0 Vision → L1 Requirements → L2 Team Detail → L3 Acceptance Criteria) to build shared understanding. Does not write code.

SamuelChien/mega-skills-collection

Research a company or person and get actionable sales intel. Works standalone with web search, supercharged when you connect enrichment tools or your CRM. Trigger with "research [company]", "look up [person]", "intel on [prospect]", "who is [name] at [company]", or "tell me about [company]".

SamuelChien/mega-skills-collection

Create forensically sound bit-for-bit disk images using dd and dcfldd while preserving evidence integrity through hash verification.

SamuelChien/mega-skills-collection

Validate messaging consistency across website, GitHub repos, and local documentation generating read-only discrepancy reports. Use when checking content alignment or finding mixed messaging. Trigger with phrases like "check consistency", "validate documentation", or "audit messaging".

Skills relacionados