Sobre el proyecto
scroll-world es una habilidad de agente (para Claude Code, Codex y otros agentes compatibles con SKILL.md) que produce una landing page inmersiva de "vuelo a través del mundo" con desplazamiento para una industria o marca. A medida que el visitante se desplaza, una cámara vuela desde el exterior de cada escena hacia su interior y continúa hacia la siguiente escena sin cortes: un vuelo continuo y conectado a través de un mundo generado.
Opciones de instalación:
- Plugin de Claude Code: `/plugin marketplace add oso95/scroll-world` y luego `/plugin install scroll-world@scroll-world`.
- Skills CLI (Vercel): `npx skills add oso95/scroll-world`, opcionalmente dirigido a un agente como Codex con `-a codex`.
- Instalación manual: clona el repositorio y copia `skills/scroll-world` en `~/.claude/skills/` o `~/.codex/skills/`.
Requisitos indicados por el proyecto:
- Monid CLI con clave de API y saldo: el backend predeterminado de la cadena de video (Seedance 2.0, facturado por clip).
- Higgsfield CLI, autenticado, con créditos: renderiza las imágenes fijas de las escenas, el respaldo kling3_0 y la cadena completa cuando Monid no está disponible.
- ffmpeg / ffprobe para la extracción de fotogramas y la codificación.
- Python 3 con Pillow para lienzos verticales móviles y la eliminación opcional de fondos transparentes en escenas.
- Codex CLI (opcional) para generar imágenes fijas de escenas mediante su image_gen integrado, facturado a una suscripción de ChatGPT en lugar de créditos de Higgsfield.
Flujo de trabajo descrito en el README:
1. Entrevista: sujeto/industria y propuesta, kit de marca (importado desde una URL, proporcionado o propuesto), dirección de arte, escenas ordenadas, versión móvil opcional (una cadena vertical 9:16 separada compuesta para teléfonos en lugar de recortada) y presupuesto con niveles de renderizado y fuente de imágenes fijas mostrados con costos estimados en créditos antes de la generación.
2. Generación de recursos: una imagen fija por escena, un clip de cámara de "inmersión" por escena y clips conectores que unen escenas consecutivas, generados a partir de los fotogramas renderizados de sus vecinos para que las uniones sean idénticas fotograma a fotograma. La opción móvil renderiza una cadena vertical paralela fijada a fotograma contra sus propios renders 9:16.
3. Conexión: un motor de desplazamiento basado en configuración reproduce toda la cadena como un solo vuelo y sirve automáticamente clips verticales y pósteres en teléfonos.
La carpeta de la habilidad contiene SKILL.md (procedimiento, regla de uniones, advertencias) y referencias: prompts.md (lista de verificación de admisión y plantillas de prompts), pipeline.md (scripts por lotes para generar → fotogramas → conectores → codificar), scrub-engine.js (motor de scrub portátil basado en configuración con blob-seek, carga diferida, fundido cruzado en uniones), index-template.html (página de montaje independiente mínima) y knockout.py (eliminación de fondo para escenas flotantes).
El README señala que el enfoque es agnóstico al framework: el pipeline, las plantillas de prompts y el motor de scrub en vanilla JS se integran en HTML simple, Next.js, Vue o una página servida por Python. También señala que la generación de recursos cuesta dinero y tiempo (aproximadamente N generaciones de imágenes más alrededor de 2N-1 generaciones de video, duplicado para la cadena móvil), que las generaciones se ejecutan en segundo plano con sondeo, y que los totales estimados se indican antes de gastar. Los recursos generados .mp4/.webp se producen por proyecto y no se incluyen en el repositorio. Licenciado bajo MIT.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.