Communitygithub.com

Army161/OpenMontage

툴킷 특화 Remotion 패턴 — 커스텀 전환, 공유 컴포넌트, 프로젝트 규칙. 핵심 Remotion 프레임워크 지식(훅, 애니메이션, 렌더링 등)은 `remotion-official` 스킬을 참조하세요.

OpenMontage란 무엇인가요?

이 스킬은 Army161/OpenMontage 저장소의 Remotion 비디오 제작 툴킷을 위한 툴킷별 패턴을 문서화합니다. 핵심 Remotion API는 공식 `remotion-official` 스킬에서 다루지만, 이 파일은 사용자 정의 전환, 공유 컴포넌트 및 프로젝트 규칙을 중점적으로 설명합니다. 제공되는 컴포넌트에는 `AnimatedBackground`, `SlideTransition`, `Label`, `Vignette`, `LogoWatermark`, `SplitScreen`, `NarratorPiP`, `Envelope`, `PointingHand`, `MazeDecoration` 등이 포함되어 있어 복잡한 비디오 구성을 빠르게 조립할 수 있습니다. 또한 `glitch`, `lightLeak`, `clockWipe`, `checkerboard`와 같은 독자적인 전환 라이브러리를 제공하며, 각 전환은 다양한 옵션과 권장 용도를 가지고 있습니다. 이 스킬은 Cursor, Claude Code, Codex와 같은 AI 에이전트 도구와 호환되며, 사용자가 저장소 내에서 툴킷 특화 컴포넌트와 전환을 정확하게 참조하고 활용할 수 있도록 도와줍니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Army161/OpenMontage/tree/HEAD/.agents/skills/remotion

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Remotion — 툴킷 확장 기능

핵심 Remotion 지식은 .claude/skills/remotion-official/에 있습니다(공식 remotion-dev/skills 저장소에서 동기화). 이 파일은 툴킷별 패턴만 다룹니다.

공유 컴포넌트

lib/components/에 있는 재사용 가능한 비디오 컴포넌트입니다. 템플릿에서 다음과 같이 가져옵니다:

import { AnimatedBackground, SlideTransition, Label } from '../../../../lib/components';
컴포넌트목적
AnimatedBackground떠다니는 도형 배경(변형: subtle, tech, warm, dark)
SlideTransition장면 전환(fade, zoom, slide-up, blur-fade)
Label선택적 JIRA 참조가 있는 떠다니는 레이블 배지
Vignette시네마틱 엣지 다크닝 오버레이
LogoWatermark모서리 로고 브랜딩
SplitScreen나란히 비디오 비교
NarratorPiP화면 속 화면 프레젠터 오버레이
Envelope열리는 플랩 애니메이션이 있는 3D 봉투
PointingHand슬라이드인 및 펄스 애니메이션이 있는 손 이모지
MazeDecoration모서리용 애니메이션 아이소메트릭 그리드 장식

커스텀 전환

툴킷에는 공식 @remotion/transitions 패키지를 넘어 장면 간 효과를 위한 lib/transitions/ 전환 라이브러리가 포함되어 있습니다.

TransitionSeries 사용하기

import { TransitionSeries, linearTiming } from '@remotion/transitions';
// 커스텀 전환 가져오기 (프로젝트 위치에 따라 경로 조정)
import { glitch, lightLeak, clockWipe, checkerboard } from '../../../../lib/transitions';
// 또는 공식 전환을 위해 @remotion/transitions에서 가져오기
import { slide, fade } from '@remotion/transitions/slide';

<TransitionSeries>
  <TransitionSeries.Sequence durationInFrames={90}>
    <TitleSlide />
  </TransitionSeries.Sequence>
  <TransitionSeries.Transition
    presentation={glitch({ intensity: 0.8 })}
    timing={linearTiming({ durationInFrames: 30 })}
  />
  <TransitionSeries.Sequence durationInFrames={120}>
    <ContentSlide />
  </TransitionSeries.Sequence>
</TransitionSeries>

사용 가능한 커스텀 전환

전환옵션최적 사용처
glitch()intensity, slices, rgbShift기술 데모, 날카로운 공개, 사이버펑크
rgbSplit()direction, displacement현대 기술, 에너제틱 전환
zoomBlur()direction, blurAmountCTA, 고에너지 순간, 강조
lightLeak()temperature, direction축하, 필름 미학, 따뜻한 순간
clockWipe()startAngle, direction, segments시간 관련 콘텐츠, 장난기 있는 공개
pixelate()maxBlockSize, gridSize, scanlines, glitchArtifacts, randomness레트로/게임, 디지털 변환
checkerboard()gridSize, pattern, stagger, squareAnimation장난기 있는 공개, 구조화된 전환

Checkerboard 패턴: sequential, random, diagonal, alternating, spiral, rows, columns, center-out, corners-in

전환 예제

// 기술/사이버펑크 느낌
glitch({ intensity: 0.8, slices: 8, rgbShift: true })

// 따뜻한 축하
lightLeak({ temperature: 'warm', direction: 'right' })

// 고에너지 줌
zoomBlur({ direction: 'in', blurAmount: 20 })

// 색수차
rgbSplit({ direction: 'diagonal', displacement: 30 })

// 시계 방향 스윕 공개
clockWipe({ direction: 'clockwise', startAngle: 0 })

// 레트로 픽셀화
pixelate({ maxBlockSize: 50, glitchArtifacts: true })

// 체커보드 패턴
checkerboard({ pattern: 'diagonal', gridSize: 8 })
checkerboard({ pattern: 'spiral', gridSize: 10 })
checkerboard({ pattern: 'center-out', squareAnimation: 'scale' })

전환 지속 시간 가이드라인

유형프레임참고
빠른 컷15-20빠르고 강렬함
표준30-45가장 일반적
극적50-60느린 공개
글리치 효과20-30갑작스러워야 함
라이트 릭45-60스윕 시간 필요

전환 미리보기

쇼케이스 갤러리를 실행하여 모든 전환을 확인하세요:

cd showcase/transitions && npm run studio

툴킷 모범 사례

  1. 프레임 기반 애니메이션만 사용 — CSS 전환/애니메이션 사용 금지; 렌더링 중 깜빡임 유발
  2. useVideoConfig()에서 fps 사용 — 애니메이션을 프레임 속도와 무관하게 만듦
  3. 보간 클램핑 — extrapolateRight: 'clamp'를 사용하여 값 폭주 방지
  4. OffthreadVideo 사용 — 복잡한 구성에서 <Video>보다 성능 우수
  5. 비동기 처리를 위한 delayRender — 데이터가 준비될 때까지 항상 렌더링 차단
  6. 에셋용 staticFile — public/ 폴더의 파일을 올바르게 참조
  7. 모든 프로젝트는 30fps 사용 — 타이밍: 프레임 = 초 × 30
  8. playbackRate는 일정해야 함 — 가변/극단 속도의 경우 FFmpeg로 전처리

프로젝트 타이밍 규칙

장면 유형지속 시간참고
제목3-5초 (90-150f)로고 + 헤드라인
개요10-20초3-5개 불릿 포인트
데모10-30초맞게 playbackRate 조정
통계8-12초3-4개 통계 카드
크레딧5-10초빠른 페이드

속도: 음성 해설 기준 약 150단어/분. 음성 해설이 타이밍을 결정합니다.

고급 API

모든 훅, 컴포넌트, 렌더러, Lambda 및 Player API에 대한 자세한 문서는 reference.md를 참조하세요.

라이선스 참고 사항

Remotion에는 특별 라이선스가 적용됩니다. 기업은 상업적 사용을 위해 라이선스를 취득해야 할 수 있습니다. https://remotion.dev/license 확인


피드백 및 기여

이 스킬에 누락된 정보가 있거나 개선할 수 있다면:

  • 패턴이 누락되었나요? 필요한 것을 설명해 주세요.
  • 오류를 찾았나요? 무엇이 잘못되었는지 알려주세요.
  • 기여하고 싶나요? 다음을 도와드릴 수 있습니다:
    1. 이 스킬을 개선 사항으로 업데이트
    2. github.com/digitalsamba/claude-code-video-toolkit에 PR 생성

"이 스킬 개선"이라고 말씀하시면 .claude/skills/remotion/SKILL.md 업데이트를 안내해 드리겠습니다.

Individual skills in this repo

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

Army161/OpenMontage

Generate AI videos from text prompts using multiple provider gateways. Use when: (1) Generating videos from text descriptions, (2) Creating AI-generated video clips for content production, (3) Image-to-video generation with a reference image, (4) Choosing between video generation providers (VEO, Kling, Sora, Runway, Seedance, MiniMax). Supports two gateways: HeyGen API and fal.ai API.

Army161/OpenMontage

Create AI avatar videos with precise control over avatars, voices, scripts, scenes, and backgrounds using HeyGen's v2 API. Use when: (1) Choosing a specific avatar and voice for a video, (2) Writing exact scripts for an avatar to speak, (3) Building multi-scene videos with different backgrounds per scene, (4) Creating transparent WebM videos for compositing, (5) Using talking photos as video presenters, (6) Integrating HeyGen avatars with Remotion, (7) Batch video generation with exact specs, (8) Brand-consistent production videos with precise control.

Army161/OpenMontage

Use p5.js/canvas for local procedural character effects: particles, weather, squash/stretch, walk cycles, and environmental motion.

Army161/OpenMontage

Review local character animation with schema checks, Playwright browser previews, frame sampling, and FFmpeg/ffprobe final output checks.

Army161/OpenMontage

Create videos from a text prompt using HeyGen's Video Agent. Use when: (1) Creating a video from a description or idea, (2) Generating explainer, demo, or marketing videos from a prompt, (3) Making a video without specifying exact avatars, voices, or scenes, (4) Quick video prototyping or drafts, (5) One-shot prompt-to-video generation, (6) User says "make me a video" or "create a video about X".

Army161/OpenMontage

Generate Mandarin and multilingual narration with Volcengine Doubao Speech 2.0. Use when creating Chinese voiceovers, when the user prefers Doubao/Volcengine/火山引擎/豆包 TTS, or when narration needs character-level timestamp metadata for subtitles.

Army161/OpenMontage

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Army161/OpenMontage

Use when implementing Disney's 12 animation principles with Framer Motion in React applications

Army161/OpenMontage

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). HyperFrames-native: single paused timeline, seek-safe, deterministic.

Army161/OpenMontage

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

Army161/OpenMontage

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

Army161/OpenMontage

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

Army161/OpenMontage

Audio and media assets for HyperFrames compositions, produced by one shared audio engine (`scripts/audio.mjs`) — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), background music + sound effects (HeyGen audio-library retrieval by default, with local Lyria / MusicGen BGM generation and a bundled SFX library as the no-credential fallback), Whisper transcription, background removal, and caption authoring. Use for voiceover / TTS, BGM, SFX / sound effects, transcription, captions / subtitles / lyrics / karaoke / per-word styling, voice + provider selection, and music-mood prompting.

Army161/OpenMontage

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, registry discovery, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

Army161/OpenMontage

Use when the user wants a short, design-led motion graphic where motion is the message: kinetic typography, stat or number count-up, chart/data-viz hit, logo sting, brand lockup, lower-third, callout, social overlay, animated headline/tweet/news item, motion poster, or quick captured-page highlight. Usually under 10s and up to ~30s, with no narration arc, voice-over, or live-action subject. Can render to MP4 or transparent overlay. Not for longer, multi-scene, narrated, or brand-reel pieces (use general-video), narrated website videos (website-to-video), topic explainers (faceless-explainer), product promos (product-launch-video), PR videos (pr-to-video), or captions on existing footage (embedded-captions). When unsure whether it's a quick motion-first piece or a longer / narrated treatment, see /hyperframes.

Army161/OpenMontage

Use when the user has a music track (an audio file, or a video to pull audio from) and wants a beat-synced HyperFrames video, calm to hard-hitting. The music drives everything: one analyzer reads it once, the orchestrator lays out the frames and fills a per-frame plan, and one sub-agent builds each frame. Typography and templates are the floor — a complete video needs zero assets — but any images or videos the user supplies are cut into the frames on the same beat grid (beat-cut / ken-burns). The genre (lyric video, slideshow, kinetic promo) falls out of the per-frame choices; the pipeline never branches on it.

Army161/OpenMontage

Best practices for Remotion - Video creation in React

Army161/OpenMontage

Port an existing Remotion (React) composition to HyperFrames HTML. Use ONLY when the user explicitly asks to port/convert/migrate/translate a Remotion source. Do NOT use: (a) authoring a new HyperFrames composition; (b) Remotion mentioned in passing; (c) Remotion code shared as reference only; (d) "same video as my Remotion one" without explicit migrate request — treat as fresh build. Doubt → `/general-video`. One-way, Remotion-only: no reverse export (HyperFrames→Remotion or any framework), no non-Remotion source (After Effects, Framer Motion, plain React/CSS) → out of scope, re-create via `/general-video`. Flags unsupported patterns (useState, useEffect, async calculateMetadata, third-party React libs, `@remotion/lambda`) and recommends runtime interop over lossy translation. Unsure whether to port vs. build fresh, or only a passing Remotion mention? → /hyperframes.

Army161/OpenMontage

Animate SVG character rigs with GSAP, CSS transforms, Remotion frame control, and HyperFrames-compatible browser previews.

Army161/OpenMontage

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

관련 스킬