Communitygithub.com

cosmic-forge

Flujo de trabajo maestro para construir experiencias web 3D cinematográficas, fotorrealistas y en tiempo real (espacio, agujeros negros, galaxias, planetas o cualquier escena de 'universo'/objeto) con recorridos de cámara impulsados por scroll, UI/UX de calidad de estudio, carga instantánea y diseños móviles perfectos. Úsalo siempre que el usuario pida un sitio web 3D/WebGL/Three.js/inmersivo/de nivel 'Awwwards'/cinematográfico con animaciones de scroll, portafolio, landing page, escena hero o de producto — o diga 'hazlo como el sitio del agujero negro'. Si el usuario no da ningún concepto, construye el predeterminado: el portafolio Event Horizon (agujero negro → galaxia → sistema solar) en templates/event-horizon.

¿Qué es cosmic-forge?

Cosmic Forge es un flujo de trabajo directivo para ingenieros creativos que construyen experiencias web 3D inmersivas y de alto rendimiento. Está diseñado para situaciones donde se requiere un sitio web 3D/WebGL impresionante, ya sea un portafolio, una landing page o una escena hero. El skill orquesta siete habilidades maestras especializadas (motor cinematográfico WebGL, realismo espacial, dirección de cámara con scroll, maestría UI/UX, rendimiento de carga instantánea, 3D primero-móvil y puerta de calidad) y las integra en un proceso de construcción paso a paso. Comienza con una fase de 'brief a tratamiento' donde se definen la imagen hero, el viaje de cámara, las páginas, la paleta de colores y la sensación de movimiento. Luego sigue un orden de construcción estricto: copiar la plantilla, personalizar contenido, trabajar la escena, la cámara, la UI, el perfil móvil, el rendimiento y finalmente la puerta de calidad. Las reglas no negociables incluyen continuidad en las transiciones sin cortes, uso de referencias reales de NASA/ESA, evitación de efectos 'genéricos de IA', texto sagrado sin obstáculos 3D, velocidad de carga en 4G y números ajustados visualmente y medidos. El skill se enfoca en lograr un resultado que parezca imposible de ejecutar en un navegador, incluso en un teléfono de gama media.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/forpc1428-eng/cosmic-forge/tree/HEAD/skills/cosmic-forge

Preguntar en tu IA favorita

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

Documentación

Cosmic Forge — el flujo de trabajo del director

Actúas como director creativo + ingeniero gráfico + líder de UI/UX al mismo tiempo. El listón: un visitante debería pensar "¿cómo está esto funcionando en un navegador?" en menos de 2 segundos, en un teléfono de gama media, sin tirones, sin recortes, sin el típico "aspecto de IA".

Este skill orquesta siete habilidades maestras. Léelas según el trabajo que toquen antes de escribir código:

HabilidadLéela cuando
webgl-cinematic-engineCualquier render 3D en tiempo real: pipeline de renderizado, shaders, TAA, bloom, tonemapping, velocidad de compilación
space-realismAgujeros negros, galaxias, nebulosas, estrellas, planetas, soles, anillos, atmósferas, iluminación, ciencia del color
scroll-camera-directionCualquier cosa que se mueva con el scroll: trayectorias de cámara, ritmo, transiciones suaves, cambios de escala
ui-ux-masteryTipografía, color, diseño, texto sobre 3D, cargadores, indicaciones, navegación, accesibilidad, copy
instant-load-performanceSiempre. Presupuesto de carga, compilación de shaders, texturas, caché, presupuesto de fotogramas
mobile-first-3dSiempre. Perfil de teléfono separado, encuadre vertical, táctil, áreas seguras
quality-gateSiempre, al final. Nada se envía sin pasar por ella

0. Comportamiento predeterminado

  • Sin concepto dado (o "hazme algo como eso"): copia templates/event-horizon/ y personalízalo (nombre, rol, correo electrónico, páginas, lista de proyectos). Esa plantilla ES el estándar de calidad de referencia: un agujero negro de Schwarzschild con cielo real lenteado → galaxia volumétrica → sistema solar fotográfico, todo en un scroll continuo. No lo "simplifiques".
  • Un concepto diferente (océano, ciudad, producto, castillo anime, bosque, átomo, ADN…): igualmente empieza desde el motor y pipeline de la plantilla (TAA, bloom, resolución dinámica, cargador, resorte de scroll, curva de ritmo, perfil móvil, indicación de scroll) y reemplaza solo los shaders de escena, las claves de cámara y el contenido. Nunca reconstruyas la instalación desde cero — ahí es donde reside la calidad.
  • Three.js solicitado explícitamente: permitido, pero aplica las mismas reglas (ver habilidad del motor §Three.js).

1. Brief → tratamiento (escribe esto antes de codificar)

Convierte cualquier solicitud — incluso de una línea — en un tratamiento de 6 líneas:

  1. Imagen hero: el fotograma único que la gente capturará en pantalla. Describe luz, color, escala.
  2. Viaje: 3–6 hitos que la cámara recorre, cada uno continuo con el siguiente (sin cortes, destellos ni túneles a menos que se pida). Ejemplo: agujero → oscuridad → galaxia → estrella → planetas → inicio.
  3. Páginas: qué contenido aparece en cada hito, y en qué lado del encuadre.
  4. Paleta: un color de luz clave, un acento, un fondo profundo. Las referencias del mundo real (fotos NASA/ESA, fotogramas de películas) superan a la imaginación.
  5. Sensación de movimiento: p. ej. "dolly majestuoso lento, acelerando hacia el agujero, pausas suaves en páginas".
  6. Presupuesto: ≤ 16 ms/fotograma en escritorio con resolución dinámica, ≤ 1.5 MB de carga inicial en teléfonos.

Si las palabras del usuario son vagas, decide con confianza y expresa tus elecciones en una línea cada una. Pregunta solo cuando una elección sea genuinamente suya (nombre de marca, correo electrónico real, nombres de proyectos reales).

2. Orden de construcción (nunca saltes, nunca reordenees)

  1. Copia la plantilla → ejecútala localmente (python -m http.server) → confirma que se renderiza.
  2. Personaliza el contenido (js/main.js → SITE, PAGES; index.html título/meta/nombre del cargador).
  3. Trabajo de escena (habilidades de motor + realismo). Cambia un hito a la vez; míralo después de cada cambio.
  4. Cámara y ritmo (habilidad scroll-camera). Ajusta con enlaces de salto estilo ?u=0.42.
  5. Capa de UI (habilidad ui-ux): paneles, navegación, cargador, indicación de scroll, etiquetas.
  6. Perfil de teléfono (habilidad mobile): encuadre, texturas, diseño, menú.
  7. Paso de rendimiento (habilidad instant-load): mide ms de GPU por hito, ms de compilación, bytes.
  8. Puerta de calidad (habilidad quality-gate). Arregla todo lo que marque. Luego envía.

3. Innegociables (las reglas del "200%")

  • Continuidad: cada transición es un movimiento de cámara a través de un solo mundo. Los saltos de escala usan el truco de dos fotogramas (habilidad del motor). Fundido solo desde/hacia negro real, nunca destello blanco.
  • Referencia real primero: texturas reales (mapas planetarios, panorámica de la Vía Láctea), física real (lenteo, Doppler, cuerpo negro, disco de Novikov–Thorne, cizalla Kepleriana), ángulos de iluminación reales.
  • Sin marcas de IA: nada de neblina morada por todas partes, sin degradados arcoíris, sin todo brillante, sin mancha de aberración cromática, sin bloom en texto, sin destellos genéricos de lente, sin UI "neón". Negros profundos. Pocos reflejos deliberados.
  • El texto es sagrado: nunca permitas que sujetos 3D se coloquen detrás de párrafos. Encuadra los sujetos en el lado opuesto (escritorio) o encima de una hoja inferior (teléfonos).
  • La velocidad es diseño: cargador visible en la primera pintura, interactivo en < 2 s en 4G para teléfonos.
  • Cada número se ajusta mirando, luego midiendo. Capturas de pantalla en cada hito, escritorio + teléfono.

4. Entrega

Termina con: lo que se construyó, la URL en vivo/local, lo que el usuario debe editar (correo electrónico, nombres), cómo desplegar (Vercel: framework "Other", sin build), y cualquier límite honesto (p. ej. "probado en emulación, no en un iPhone físico").

Individual skills in this repo

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

mobile-first-3d

Dedicated phone/tablet experience for heavy 3D/WebGL sites — device profile detection, lighter render settings and texture sets, portrait camera framing so subjects (planets with rings, galaxies) are never clipped, bottom-sheet content, menu sheet, safe areas, touch behaviour and shorter scroll. Use always when building a 3D site, and whenever someone says "on mobile it's cut off / not seen perfectly / slow / ugly".

space-realism

Physically grounded, photoreal look-development for space and natural scenes — black holes and accretion disks, spiral galaxies, nebulae, star fields, the Sun, planets, moons, rings, atmospheres, lighting angles and colour science — plus how to avoid the generic "AI render" look. Use whenever a scene contains space objects or must look "real", "ultra detailed", "NASA-like", "Interstellar-like", or currently looks bland, plastic, hazy or fake.

ui-ux-mastery

Studio-level UI/UX for immersive and 3D websites — typography systems, colour tokens and contrast, layout over moving 3D, text panels, navigation and phone menus, custom loaders, idle scroll cues, micro-interactions and easing, copywriting, accessibility and reduced motion. Use when designing or reviewing any interface layer, portfolio, landing page or hero; when something looks "generic", "AI-made", "cluttered", "not premium"; or when text is unreadable over visuals.

webgl-cinematic-engine

Film-quality real-time rendering in the browser with raw WebGL2 (or Three.js): fullscreen raymarching, geodesic/raytraced scenes, temporal anti-aliasing, dynamic resolution, physically based bloom, ACES tone mapping, grain, sky baking, multi-scale scenes, and shader compile-time tricks for Windows/ANGLE. Use for any 3D/WebGL/GLSL/shader/Three.js scene work, black holes, volumetrics, or when a scene looks flat, aliased, flickery, slow or "CG".

Skills relacionados