Communitygithub.com

RoleModel/rolemodel-openscreen

RoleModel 브랜드를 HyperFrames 영상에 적용합니다 — design.md 출처, 사용할 모션 토큰, 브랜드 금지 사항, 내레이션 및 클라이언트 전달 작업 방식을 정의합니다. 'RoleModel 영상 제작', '이 구성에 브랜딩 적용', '이 easing은 무엇을 써야 하나', '녹화에 모션 그래픽 추가'와 같은 요청이나 RoleModel 또는 Academy 브랜드가 적용된 HyperFrames 구성을 작성할 때 사용합니다. 기존 HyperFrames 스킬 위에 얇은 레이어로 추가되어, 우리의 것을 더하고 나머지는 위임합니다.

rolemodel-openscreen란 무엇인가요?

이 스킬은 HyperFrames 기반 영상 제작 시 RoleModel 브랜드를 일관되게 적용하기 위한 브랜드 레이어입니다. 핵심은 `design.md` 파일을 통해 브랜드 색상, 폰트, 모션 원칙을 주입하며, 모션 토큰 선택 시 시각적 효과가 아닌 요소의 기능적 역할(등장, 퇴장, 이동, 강조 등)에 따라 결정하도록 규칙을 제공합니다. 방사형 그라데이션, 프레임 와이프, 장식선, 오렌지 배경 사용 등 브랜드에서 금지하는 사항을 명확히 정의하고, 방향이 확정되지 않은 상태에서는 `hyperframes-direction-harness`를 통해 검토 가능한 보드를 먼저 생성하도록 안내합니다. 내레이션은 `rm-voice`로 로컬에서 합성하여 클라이언트 제품 정보가 외부로 유출되지 않도록 하고, 최종 렌더링과 내레이션 트랙의 시간차 문제는 `rm-mux`로 정확히 동기화합니다. HyperFrames 스킬의 규칙을 중복 서술하지 않고, 브랜드 관련 부분만 추가하여 유지보수성을 높였습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/RoleModel/rolemodel-openscreen/tree/HEAD/skill/hyperframes-brand

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

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

문서

RoleModel HyperFrames 브랜드

이미 HyperFrames 도구가 깊이 설치되어 있습니다. 처음부터 시작하지 말고 그 도구 목록에서 출발하세요. 이 스킬은 그 위에 브랜드 레이어만 추가합니다: 가치의 출처, 어떤 것을 사용할지, 그리고 하지 않는 일들.

도구 목록

두 세트가 설치되어 있으며, 이름이 겹칩니다. 어떤 것을 호출하는지 알아야 합니다.

공식 (HeyGen), ~/.claude/skills:

스킬사용时机
hyperframes구성 작성, 타이밍, 미디어, 제작 워크플로
hyperframes-core구성 계약 및 data-* 타이밍 속성
hyperframes-animation모션 규칙, 씬 청사진, GSAP 및 기타 런타임
hyperframes-keyframes확대/축소, 카메라 이동, 재구성, seek-safe 키프레임
hyperframes-creative팔레트, 비트 계획, 내레이션, 구성 패턴
hyperframes-audio이미 배치된 트랙 믹싱 — 페이드, 덕킹, 오토메이션
hyperframes-cli초기화, 린트, 점검, 미리보기, 렌더링, 자막, TTS
hyperframes-registry블록 및 컴포넌트 설치
media-use음악, SFX, 이미지, 음성 소싱 또는 생성

표준 (우리 것), ~/.claude/skills/synced:

스킬사용时机
hyperframes우리 자체 구성 스킬 — design.md, house-style.md 읽음
hyperframes-cli우리 자체 CLI 노트
hyperframes-direction-harness방향이 확정되지 않았을 때 최종 index.html 작성 전에
optics-context제품 표면도 함께 다뤄야 할 때
gsapGSAP 세부 사항
impeccable우리의 제작 기준

이름 충돌. hyperframes와 hyperframes-cli는 두 세트에 모두 존재합니다. 어떤 것을 가져올지가 중요할 때는 명시적으로 말하세요.

여기에 그들의 규칙을 다시 서술하지 마세요. 구성 계약, 린트 오류, 트랙 충돌, 일시 정지된 타임라인 — 모두 해당 스킬에 속하며 거기서 유지됩니다. 사본을 만들면 업스트림에서 릴리스가 나올 때마다 차이가 생기고 아무도 눈치채지 못합니다. 규칙이 누락되었다면 이 파일이 아니라 업스트림에서 수정하세요.


브랜드가 design.md를 통해 HyperFrames에 도달하는 방식

표준 hyperframes 스킬은 이미 프로젝트 루트의 design.md를 *"브랜드 색상, 폰트, 제약 조건의 진리 원천"*으로 읽고, 정확한 값을 사용하도록 지시받습니다. 그것이 연결 고리입니다. 사용하세요.

브랜드 저장소에서 하나를 생성합니다:

cp rolemodel-brand/dist/design.md <video-project>/design.md

이 파일은 rolemodel-brand/tokens/brand.json에서 scripts/build-tokens.mjs로 생성되므로, 다른 RoleModel 표면에서 사용하는 토큰과 불일치할 수 없습니다. 직접 편집하지 마세요 — brand.json을 변경하고 다시 실행하세요.

이 파일에는 색상, 타이포그래피, 전체 모션 스케일, 네 가지 모션 원칙, 그리고 아래의 제약 조건이 포함됩니다. 프로젝트에 추가되면 기존 스킬이 나머지를 처리합니다.

구성 자체의 CSS 사용자 정의 속성:

<link rel="stylesheet" href="rolemodel-brand/css/academy-theme.css">
<body data-theme="academy">

모션 토큰 선택

전체 값은 design.md에 있습니다. 선택 규칙은 짧습니다:

요소가 어떻게 보이는지가 아니라 무엇을 하는지에 따라 선택하세요.

  • 무언가가 도착할 때 → --duration-base + --ease-enter
  • 같은 것이 사라질 때 → --duration-fast + --ease-exit. 떠나는 것은 항상 도착하는 것보다 빠릅니다.
  • 이미 화면에 있는 것이 위치나 크기를 바꿀 때 → --ease-move
  • 의도적인 주목 유도 → --ease-emphasis, 오버슈트가 허용되는 유일한 곡선
  • 그룹 → 형제 요소 간에 하나의 --stagger, 절대 동시에 하지 않음

구성에 원시 지속 시간이나 원시 cubic-bezier를 절대 작성하지 마세요. 스튜디오가 색상에 적용하는 동일한 규칙입니다.

하지 않는 일

다음은 필수 사항입니다. 몇 가지는 툴킷의 npm run check로 강제되며, 모두 구성 스킬이 읽을 design.md에 있습니다.

  • 방사형 그라데이션은 절대 사용하지 않음. 브랜드는 선형입니다 — 방향, 덩어리가 아닙니다.
  • 프레임 와이프 없음. 씬 전환으로 흰색 또는 밝은 선 프레임, 테두리, 상자를 그리지 마세요. Claude는 프롬프트 없이도 이것을 사용합니다; 이는 템플릿 장식에 불과하며 우리 것이 아닙니다. 주의를 아무것도 향하지 않습니다. 컷으로 전환하거나, --ease-enter로 들어오는 콘텐츠를 드러내세요. 프레임 주위에 상자를 그리지 않습니다.
  • 장식선, 밑줄, 구분선 없음. 제목에 밑줄을 긋거나, 섹션 사이에 키라인을 넣거나, 카드, 통계, 인용문, 하단 써드 주위에 테두리를 그리지 마세요. Claude는 구조를 나타내기 위해 이것을 사용합니다; 그것은 무언가가 추가되었음을 나타낼 뿐입니다. 분리는 공간, 무게, 배경에서 옵니다. 시스템에서 유일하게 허용된 규칙은 제목 아래의 짧은 브랜드 바이며, rm-title이 그립니다 — 두 번째 것을 직접 추가하지 마세요.
  • 가장자리는 단색 테두리이며, 페이드가 아닙니다. 이것은 필요한 가장자리를 그리는 방법을 규정할 뿐, 추가할 권한을 주지 않습니다. 가장자리 없이도 모호하지 않다면, 가장자리는 없습니다.
  • 주황색은 강조색일 뿐 — 배경으로 사용하지 마세요.
  • 장식 없음. 요소가 정보를 전달하거나 주의를 유도하지 않으면 제거하세요.

방향이 확정되지 않았을 때

index.html 작성을 시작하지 마세요. hyperframes-direction-harness를 사용하세요 — 정확히 이를 위해 만들어졌으며, 구성 전에 검토 가능한 보드를 생성합니다:

01_intake.md → 02_design_direction.md → 03_critical_frame_plan.md
             → direction_board.html  (Director Workbench, 검토)
             → 04_render_plan.md     (검토 후에만 준비)
             → hyperframes 스킬에 전달

기존 구성의 작은 수정(오타, 타이밍 조정, 색상 하나, 린트 수정)에 대해서만 우회하세요.

어떤 도구가 어떤 문제를 해결하는가

HyperFrames는 구성합니다; 캡처하지 않습니다. 영상이 실제 제품 UI를 보여줘야 한다면, 잘못된 도구입니다.

입력도구최신 상태 유지?
녹화화면openscreen아니요 — 수동으로 다시 녹화
구성스크립트 또는 브리프HyperFrames브리프 재실행
테스트에서Playwright 트레이스playwright-recast예 — 테스트 재실행

캡처 위에 올라가는 타이틀 카드, 하단 써드, 모션 그래픽에는 HyperFrames를 사용하세요.

내레이션, 타이밍, 전달

구성 내에서 내레이션을 합성하지 마세요.

rm-voice <project> --script opener --voice af_nova

한 줄에 한 클립, 각각 측정된 SRT가 이미 알려진 지속 시간에서 작성되므로 타이밍이 정확하며, 복사 편집은 변경된 부분만 다시 합성합니다. Kokoro는 로컬에서 실행됩니다: API 키가 필요 없으며, 미출시 클라이언트 제품에 대한 정보는 기계를 떠나지 않습니다.

렌더와 내레이션 트랙은 다른 시계를 사용합니다. playwright-recast는 유휴 시간을 압축합니다; 내레이션은 단어가 걸리는 시간만큼 길어집니다. 22초 자막 트랙을 3.8초 렌더에 구우면 큐 1이 전체 클립 동안 대기하고 나머지는 조용히 드롭됩니다 — 작동한 것처럼 보입니다.

rm-mux --video demo.mp4 --audio narration.wav --srt narration.srt -o final.mp4
rm-share final.mp4 --project "Ridgeline Railing"

rm-share는 클라이언트가 계정 없이 열고 타임스탬프가 찍힌 댓글을 남길 수 있는 링크를 반환합니다. rm-share --check는 구성 여부를 알려줍니다.

클라이언트 프로젝트 전

export HYPERFRAMES_NO_TELEMETRY=1

텔레메트리는 기본적으로 켜져 있습니다. 프로젝트 이름과 비디오 콘텐츠는 수집되지 않지만, hyperframes auth login은 HeyGen 계정 이메일을 사용량에 연결하고 이전 익명 활동을 연결합니다. 스캐폴딩에서 옵트아웃을 설정하세요.

버전을 고정하세요. HyperFrames는 Apache-2.0입니다 — 시트 수, 회사 규모 제한이 없어 기본값이지만, 1.0 미만이며 명시된 호환성 보장 없이 거의 매일 릴리스됩니다. 오늘 렌더링되는 클라이언트 프로젝트는 6개월 후에도 동일하게 렌더링되어야 합니다.


크레딧

세 가지 수준의 프레이밍과 컷 → 스토리보드 → 모션 그래픽 파이프라인은 CC BY 4.0 라이선스로 사용된 RoboNuggets의 Jay의 hyperframes-helper에서 가져왔습니다. 이 내용을 재공유할 경우 저작자 표시를 유지하세요 — 이것이 라이선스 조건입니다.

관련 스킬