Communitygithub.com

MattiaIppoliti/tia-skills

전문 작업 흐름이 없을 때 사용자 정의 HyperFrames 구성을 작성하거나 편집합니다. BRIEF.md에서 flow가 companion으로 설정된 경우에도 사용합니다. 긴 장면이나 여러 장면의 작품, 브랜드 및 시즐 릴, 몽타주, 정적 루프, 정적 타이틀 카드, 푸티지 리믹스, 자유 형식 빌드에 적합합니다. 짧고 내레이션이 없는 모션 우선 단위(애니메이션 타이틀 포함)에는 motion-graphics를 대신 사용하세요. 이 스킬을 사용하기 전에 hyperframes를 통해 새 제작물을 라우팅하세요.

tia-skills란 무엇인가요?

이 스킬은 HyperFrames 에코시스템 내에서 일반 비디오 편집 및 생성을 위한 전문 작업 흐름입니다. 고유한 디렉터리 구조, 스토리보드, 검토 루프, 미디어 관리를 포함한 포괄적인 프레임워크를 제공합니다. 자동화(automation) 또는 협업(companion) 흐름을 지원하며, 자동화 모드에서는 사용자 입력 없이 전체 비디오 생성 파이프라인을 실행하고, 협업 모드에서는 감독 역할을 수행하여 사용자와 함께 창의적인 결정을 내립니다. 이 스킬은 현재 retired된 HTML/GSAP 기반 파이프라인을 설명하지만, Remotion + React로의 전환 중에 있으며, 프레임워크에 구애받지 않는 제작 기술(스토리 구성, 컷 리듬, 비주얼 디자인)을 활용할 것을 권장합니다. 또한 Figma 디자인 가져오기, 미디어 처리, 인증된 제공자 통합 등 다양한 어댑터를 지원하며, 프로젝트 상태에 따라 브리핑 작성, 기존 프로젝트 이어가기, 또는 특정 편집 작업을 수행합니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/MattiaIppoliti/tia-skills/tree/HEAD/skills/video/general-video

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

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

문서

⚠ 계약 상태: 아직 Remotion으로 포팅되지 않음

이 스택의 출력 프레임워크는 Remotion + React (/hyperframes-core)입니다. 이 스킬은 여전히 retired된 HTML + data-* + 일시 정지된 GSAP 타임라인 파이프라인을 설명하며, 번들된 스크립트는 여전히 해당 계약으로 index.html을 생성합니다.

포팅될 때까지:

  • 실행하지 마십시오 npx hyperframes <anything> — 해당 CLI는 retired되었습니다. /hyperframes-cli 모든 이전 명령을 Remotion에 매핑합니다.
  • 복사하지 마십시오 data-* 마크업 또는 GSAP 타임라인 코드를 Remotion 프로젝트에 복사하지 마십시오.
  • 가져오십시오 해당 기술(스토리 형태, 컷 리듬, 비주얼 디자인, 화면에 표시할 내용에 대한 결정)을 가져오십시오. 해당 부분은 프레임워크에 구애받지 않으며 이 스킬이 여기에 남아 있는 이유입니다.
  • 표현하십시오 결과를 /hyperframes-core의 계약을 통해: <Composition>, <Sequence>, 및 useCurrentFrame()에서 파생된 값.

이 문제를 해결해야 했던 경우 요약에 언급하여 포트를 완료할 수 있도록 하십시오.

일반 비디오

이 작업 흐름에 의존하기 전에 다음을 실행하십시오:

npx hyperframes skills update general-video

성공적인 no-op는 스킬이 최신임을 의미합니다. 메모리에서 계속하는 대신 업데이트 실패를 표시하십시오.

1. 교차 소스 어댑터 적용

  • 미디어: 오디오, 이미지, 아이콘, 로고, 음성, 그레이딩, LUT, 치료/효과, 캡션 또는 미디어 작업이 필요한 경우 /media-use를 로드하고 ../media-use/references/resolve.md (확인, 채택, 재사용) 및 ../media-use/references/setup-providers.md (제공자, 인증)를 따르십시오. 모호한 푸티지 피드백 및 명명된 스타일은 편집 전에 ../media-use/references/media-treatments.md를 사용하십시오. CSS/SVG/불투명도로 지원되지 않는 미디어 효과를 즉석에서 구현하지 마십시오. 첫 번째 인증된 제공자 작업 전에 npx hyperframes auth status를 실행하고 출력을 그대로 전달하십시오. 로그아웃된 경우 ../hyperframes-core/references/brief-contract.md의 게이트를 적용하십시오: 협업 모드는 로그인 또는 명시적 오프라인 선택을 기다립니다. 자율 모드는 상태를 명시하고 사용 가능한 오프라인 제공자를 통해 계속 진행합니다. 필수 기능을 충족할 수 있는 오프라인 제공자가 없으면 차단기를 표시하십시오. 로컬 채택만으로는 인증 게이트가 필요하지 않습니다.
  • Figma: 입력이 figma.com URL이면 먼저 /figma를 실행하십시오. 내보낸 에셋, 토큰, 컴포넌트 또는 스토리보드 프레임에서 빌드하십시오. SVG 위생 처리, 미디어 출처 및 브랜드 토큰 바인딩을 건너뛰므로 원시 Figma 커넥터 호출을 사용하지 마십시오.

이러한 어댑터는 /hyperframes에서 선택한 작업 흐름을 변경하지 않습니다.

2. 프로젝트 상태에서 시작

일치하는 첫 번째 행을 적용하고 하위 상태 행을 평가하지 마십시오:

상태작업
특정 편집편집을 수행하고 기존 프로젝트 결정을 유지한 다음 영향을 받는 검사를 다시 실행하십시오. 검색을 다시 열지 마십시오.
BRIEF.md가 존재함읽으십시오. workflow가 다른 작업 흐름을 지정하고 flow가 companion이 아니면 인계하십시오. 브리핑 질문을 하지 마십시오.
브리핑은 없지만 hyperframes.json 또는 STORYBOARD.md가 존재함파일 및 기록된 선호도에서 재개하십시오. 알려진 사실에서만 BRIEF.md를 백필하십시오.
새 제작/hyperframes 및 해당 의도 계층을 실행하십시오. workflow: general-video 또는 flow: companion인 경우에만 여기로 돌아오십시오.

새 프로젝트의 경우 브리핑에서 kebab-case 디렉토리 이름을 선택하고 브리핑을 작성하기 전에 스캐폴딩하십시오:

npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=general-video

그런 다음 ../hyperframes-core/references/brief-format.md를 사용하여 프로젝트 루트에 BRIEF.md를 작성하십시오. 기존 프로젝트에서 루트는 hyperframes.json이 포함된 디렉토리입니다. node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes <PROJECT_ROOT>를 사용하여 브리핑 형식이 지정한 확인된 선호도 기반 필드만 기록하십시오. 추론된 기본값을 기록하지 마십시오. 여기서 <MEDIA_DIR>은 설치된 /media-use 스킬 디렉토리이고 <PROJECT_ROOT>는 hyperframes.json이 포함된 디렉토리입니다. 의도 계층이 레시피를 채택한 경우 node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes <PROJECT_ROOT> --name <name>를 사용하여 지금 적용하고 다시 묻지 마십시오.

3. 실행 형태 해석

../hyperframes-core/references/brief-contract.md의 표준 용어만 사용하십시오:

필드의미효과
flow누가 주도하는지automation: 경로를 선택하고 실행합니다. companion: 대화를 통해 공동 제작합니다.
storyboard보드가 검토 표면인지 여부yes: 계획 및 스케치 검토를 실행합니다. no: 보드 없이 빌드합니다.
파생된 mode체크포인트 게이트가 작동하는 방식브리핑 계약을 따르십시오. 사용자에게 모드 이름을 묻지 마십시오.

이러한 상태에 대한 동의어를 발명하지 마십시오. 진행 중인 "그냥 빌드해" 신호는 의도 계층에서 처리되며 flow: automation, storyboard: no로 도착합니다.

  • flow: automation의 경우 경로를 선택하고 첫 번째 진행 업데이트에서 한 줄로 표시하십시오.
  • 특정 편집의 경우 새 경로를 발명하지 않고 편집을 수행하십시오.

하드 컷, 트림, 스플라이스 또는 기존 푸티지 재정렬의 경우 동일한 비디오 소스를 여러 클립 요소에 복제하십시오. 각 복사본에서 data-media-start 및 data-duration으로 소스 범위를 설정한 다음 data-start로 작성된 배치/순서를 설정하십시오. 별도로 작성된 오디오는 일치하는 <audio> 요소에서 동일한 클립 범위와 타이밍을 따릅니다. /hyperframes-core가 이 시간 편집을 소유합니다. 내부 래퍼에서 확대/축소, 펀치, 팬, 자르기, 마스크 또는 clip-path와 같은 시각적 속성 애니메이션에만 /hyperframes-keyframes를 사용하십시오. ../hyperframes-core/references/editing-recipes.md에서 전체 계약을 복사하십시오.

동반자 흐름

flow: companion인 경우:

  • BRIEF.md를 읽고 수락된 ## Assets 및 ## Customizations를 프로젝트 아티팩트와 조정하십시오. 아직 완료되지 않은 수락된 작업을 완료하십시오. 완료된 작업은 그대로 두십시오. 수락된 기능을 새로운 것처럼 다시 제공하지 마십시오.
  • 계약자가 아닌 감독으로 도착하십시오. 동반자를 선택한 사용자는 참여와 품질을 선택했습니다. 정직한 응답은 당신이 설계할 수 있는 최고의 버전이지, 방어할 수 있는 가장 작은 버전이 아닙니다. 첫 번째 계획은 최고 수준의 처리입니다: 스토리 아크(가장 가까운 장르 렌즈 — 메뉴 § 장르 렌즈 대여), 디자인 사양, 각 장면의 모션 처리 이름(§ 5의 계획 규율), 전환, 오디오 아이덴티티 — 음악 및 사운드 마크, 또는 의도적인 침묵 — 사용자의 자료 배치, 설계된 오프닝 및 클로징. 각 레이어가 추가하는 내용을 한 줄로 말하십시오. 비용이 많이 드는 것(렌더링 시간, 로그인, 청구)을 언급할 때 표시하십시오. 사용자는 처리를 줄입니다. 승인별로 조립하게 해서는 안 됩니다.
  • 최고 수준은 개념에 속하며 도구 상자에 속하지 않습니다. 모든 레이어는 브리핑의 메시지를 제공해야 합니다 — 모든 비디오를 같은 방식으로 꾸미는 처리는 장식입니다. 제작은 최고 수준으로 올라갑니다. 콘텐츠는 요청된 것 이상으로 성장하지 않습니다(§ 6).
  • 체크포인트 사이에 ../hyperframes/references/capability-menu.md는 두 가지 방식으로 작동합니다. 트리거 목록으로: 사용자가 입력을 언급하거나 빌드가 필요에 도달할 때 관련 기능을 제공하십시오. 각 패스의 업그레이드 채널로: 계획, 스케치 또는 빌드 체크포인트는 사용자가 보고 있는 자료를 가리키는 하나 또는 두 개의 추적된 제안을 전달할 수 있습니다("장면 3의 통계는 카운트업 처리를 원합니다"). 제공하기 전에 읽으십시오. 전체 카탈로그를 덤프하지 마십시오.
  • 사용자가 기능을 수락한 후 해당 아티팩트를 생성하고 일치하는 BRIEF.md 본문 섹션에 결정을 즉시 기록하십시오. 사용자가 명시적으로 변경할 때만 frontmatter 필드를 다시 작성하고 확인된 선호도를 기록하십시오.
  • 동일한 스토리보드, 검증, 최종 미리보기 및 렌더링 승인 게이트를 유지하십시오. 동반자는 누가 조종하는지 변경할 뿐, 품질에 필요한 것을 변경하지 않습니다.

4. 각 단계 전에 필요한 지식 로드

조건이 일치할 때 이러한 읽기는 필수입니다:

조건작업 전 읽기
모든 구성 HTML 또는 장면 레이아웃/hyperframes-core; 레이아웃 계약을 위해 references/determinism-rules.md 사용
모든 중요하지 않은 제작 또는 시각적 처리/hyperframes-creative → references/house-style.md 및 references/video-composition.md
모든 모션, 애니메이션 또는 장면 전환/hyperframes-animation; 해당 라우팅을 따라 일치하는 규칙, 어댑터, 청사진 또는 전환 참조로 이동
storyboard: yes../hyperframes-core/references/storyboard-format.md 및 ../hyperframes-core/references/review-loop.md
모든 미디어 자산 또는 작업(내레이션, BGM, SFX, 캡션, 그레이딩 또는 변환 포함)/media-use; 프레임워크 재생 및 배치를 위해 /hyperframes-core → references/media.md도 읽으십시오
여러 장면 어셈블리../hyperframes-core/references/production-loop.md
flow: companion, 첫 번째 계획 전/hyperframes-creative → references/story-spine.md 및 references/house-style.md; 가장 가까운 장르 렌즈 및 전체 ../hyperframes/references/capability-menu.md — 최고 수준 처리는 이들로부터 설계되며 기억에서 설계되지 않음
동반자 기능 제공, 캡처, 비트 그리드, 생성형 비디오, 맵, 게시 또는 교차 작업 흐름 기능../hyperframes/references/capability-menu.md
디자인 사양이 존재함, 최종 승인 전/hyperframes-creative → references/design-adherence.md

이러한 읽기를 기억으로 대체하지 마십시오. 점진적 공개는 일치하는 참조가 실제로 로드된 경우에만 컨텍스트를 저장합니다.

5. 구성 실행

이 종속성 순서를 사용하십시오. 입력이 없는 경우에만 단계를 건너뛰십시오.

  1. 계획. 시청자 아크, 구조, 리듬 및 지속 시간 드라이버를 명시하십시오. 짧은 단일 장면에는 하나의 파일을 사용하십시오. 세 개 이상의 하드 장면 컷 또는 재사용된 장면에는 하위 구성을 사용하십시오. 내레이션 아크에는 /hyperframes-creative → references/story-spine.md, 리듬에는 references/beat-direction.md, 구조에는 /hyperframes-core → references/project-structure.md를 읽으십시오. 개방형 여러 장면 브리핑의 경우 /hyperframes-creative → references/prompt-expansion.md를 통해 프롬프트를 확장하십시오. 여러 장면 계획은 각 장면의 형태를 인용합니다: 적합한 청사진이 있는 경우 /hyperframes-animation → blueprints-index.md의 청사진 ID, 또는 적합한 청사진이 없는 경우 rules-index.md에서 구성하는 명명된 규칙 — 모션 이름은 해당 인덱스에서 가져오며 결코 발명되지 않습니다. 스토리 진실이 어떤 장면이 존재하는지 결정합니다. 인용이 장면을 꾸밉니다. 여러 장면 계획은 또한 디스패치 아티팩트로 기록됩니다: STORYBOARD.md의 장면당 하나의 ## Frame N 블록 — status: outline, 선언된 src:, 청사진/규칙 인용, 비트 텍스트 — storyboard: no인 경우에도. 블록은 디스패치 단위입니다. 보드는 검토 표면일 뿐입니다.
  2. 요청 시 계획 검토. storyboard: yes의 경우 해당 블록에 대해 공유 검토 루프를 실행하십시오. storyboard: no의 경우 보드를 열지 않고 계속하십시오. 어쨌든 계획 일시 중지가 발생하면…

… [번역을 위해 잘림]

Individual skills in this repo

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

MattiaIppoliti/tia-skills

The technique catalog: five velocity-matched SEAMS (zoom-through, INVERSE zoom-through, cut-the-curve, waterfall cut, rack-focus blur-cut) plus the two in-scene techniques — waterfall ENTRY (staggered arrival cascades for title cards / segment openers) and the nudge curve (slow-fast-slow three-phase group slides). Covers partial-travel (~12% of frame) velocity matching via mirrored power4 eases, the Z scale-sign rule, size-scaled blur (10px text / 18-20px full-frame), word-by-word staggered cuts, cascade pacing by element weight, and the 10/65/25 slide ratio. Read before authoring any transition, text-beat handoff, kinetic text entry, or group reposition. [depth, zoom, inverse-zoom, scale-sign, mirrored-zoom, rack-focus, pacing, velocity, cut-the-curve, waterfall, stagger, cascade, kinetic-text, title-card, segment-opener, nudge, slide, easing, group-motion, z-depth, motion-graphics, cinematic, transition, blur, directional-continuity]

MattiaIppoliti/tia-skills

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

MattiaIppoliti/tia-skills

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). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

MattiaIppoliti/tia-skills

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), or automation envelopes drawn on a track's volume or any effect parameter. Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

MattiaIppoliti/tia-skills

Drive the Remotion CLI development loop: scaffold, studio, type-check, compositions, still probes, single and batch render, bundle, Lambda and Cloud Run rendering, benchmark, versions, upgrade, and GPU checks. Also use when diagnosing a build or render failure, or when looking for a capability the retired HyperFrames CLI used to own.

MattiaIppoliti/tia-skills

The composition contract for building one renderable Remotion project. Use for project structure, `<Composition>` registration, `<Sequence>` timing, layer/track ordering, scene components, props and schemas, framework-owned media playback, deterministic-render rules, and validation. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition code.

관련 스킬