scroll-world

scroll-world는 산업이나 브랜드를 위한 몰입형 스크롤 스크럽 "세계를 비행하는" 랜딩 페이지를 생성하는 에이전트 스킬(Claude Code, Codex 및 기타 SKILL.md 호환 에이전트용)이다. 방문자가 스크롤하면 카메라가 각 장면 외부에서 내부로 비행하고 컷 없이 다음 장면으로 이어진다. 즉, 생성된 세계를 통과하는 하나의 연속된 연결 비행이다. 설치 옵션: - Claude Code 플러그인: `/plugin marketplace add oso95/scroll-world` 후 `/plugin install scroll-world@scroll-world`. - Skills CLI(Vercel): `npx skills add oso95/scroll-world`, 선택적으로 `-a codex`로 Codex 같은 에이전트를 지정할 수 있다. - 수동 드롭인: 저장소를 클론하고 `skills/scroll-world`를 `~/.claude/skills/` 또는 `~/.codex/skills/`에 복사한다. 프로젝트가 명시한 요구 사항: - API 키와 잔액이 있는 Monid CLI — 기본 비디오 체인 백엔드(Seedance 2.0, 클립당 과금). - 인증되고 크레딧이 있는 Higgsfield CLI — 장면 스틸, kling3_0 폴백, Monid가 없을 때 전체 체인을 렌더링한다. - 프레임 추출 및 인코딩을 위한 ffmpeg / ffprobe. - 모바일 세로 캔버스와 선택적 투명 장면 녹아웃을 위한 Pillow가 포함된 Python 3. - Codex CLI(선택 사항) — 내장 image_gen으로 장면 스틸을 생성하며, Higgsfield 크레딧 대신 ChatGPT 구독으로 과금된다. README에 설명된 워크플로: 1. 인터뷰 — 주제/산업과 피치, 브랜드 키트(URL에서 가져오거나 제공하거나 제안), 아트 디렉션, 순서가 지정된 장면, 선택적 모바일 버전(크롭이 아니라 휴대폰용으로 구성된 별도의 9:16 세로 체인), 렌더 어와 스틸 소스를 포함한 예산이 생성 전에 예상 크레딧 비용과 함께 표시된다. 2. 에셋 생성 — 장면당 스틸 하나, 장면당 "다이브인" 카메라 클립 하나, 연속 장면을 연결하는 커넥터 클립을 생성하며, 이웃 장면의 렌더링된 프레임에서 생성되어 이음새가 프레임 단위로 동일하다. 모바일 옵트인은 자체 9:16 렌더에 프레임 고정된 병렬 세로 체인을 렌더링한다. 3. 배선 — 구성 기반 스크롤 엔진이 전체 체인을 하나의 비행으로 재생하고 휴대폰에서 세로 클립과 포스터를 자동으로 제공한다. 스킬 더에는 SKILL.md(절차, 이음새 규칙, 주의 사항)와 참고 자료가 포함되어 있다: prompts.md(인테이크 체크리스트와 프롬프트 템플릿), pipeline.md(generate → frames → connectors → encode용 배치 스크립트), scrub-engine.js(blob-seek, 지연 로드, 이음새 크로스페이드를 갖춘 이식 가능한 구성 기반 스크럽 엔진), index-template.html(최소 독립 마운팅 페이지), knockout.py(떠 있는 장면용 배경 녹아웃). README는 이 접근 방식이 프레임워크에 구애받지 않는다고 언급한다: 파이프라인, 프롬프트 플릿, 바닐라 JS 스크럽 엔진은 일반 HTML, Next.js, Vue 또는 Python으로 제공되는 페이지에 그대로 적용할 수 있다. 또한 에셋 생성에는 비용과 시간이 다는 점(대략 N번의 이미지 생성에 약 2N-1번의 비디오 생성, 모바일 체인의 경우 두 배), 생성이 폴링과 함께 백그라운드에서 실행된다는 점, 지출 전에 예상 총액이 명시된다는 점을 언급한다. 생성된 .mp4/.webp 에셋은 프로젝트별로 생성되며 저장소에 포함되지 않는다. MIT 라이선스.