Communitygithub.com

designos-beat-edit-video

design:os 스튜디오 앱을 마케팅하는 영상을 제작합니다. 실제 앱 화면, 새로운 아이디어, 비주얼, 움직임, 음악을 매번 새롭게 구성하여 TikTok/Reels/Shorts 비트 편집 영상과 승인된 베트남어 음성이 포함된 3-5분 YouTube 튜토리얼을 만듭니다.

designos-beat-edit-video란 무엇인가요?

이 스킬은 design:os 스튜디오 앱을 홍보하는 마케팅 영상을 제작하기 위한 완전한 파이프라인입니다. 매 영상마다 새로운 아이디어, 구조, 색상, 움직임, 음악을 사용하여 이전 영상과 완전히 달라야 합니다. 핵심 원칙은 앱 자체가 주인공이어야 하며, 모든 장면은 실제 앱에서 새로 녹화된 영상으로 구성됩니다. Openscreen을 통해 앱 화면을 캡처하고, Python 스크립트(render.py, audio.py 등)를 사용하여 비트에 맞춰 편집된 최종 영상을 생성합니다. 또한 3-5분 분량의 YouTube 튜토리얼을 위한 별도 파이프라인(longform/)을 제공하며, 여기에는 베트남어 TTS 음성(VieNeu-TTS v3 Turbo, 'Hải Đăng' 프리셋)과 자막 생성 기능이 포함되어 있습니다. Prompt Motion Bridge 도구를 통해 매 영상마다 최소 5개의 새로운 모션 레퍼런스를 확보하고, 모든 영상에는 '소스 사용 가능(source-available)'이라는 올바른 용어를 사용하며, 출시되지 않은 기능이나 경쟁사 비방은 절대 포함하지 않습니다.

지원 대상~Claude Code✓Codex CLI✓Cursor
npx skills add https://github.com/NamAIEngineer/bundle-skill-video/tree/main/designos-beat-edit-video

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

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

문서

designos-beat-edit-video은(는) 무엇을 하나요?

목적: design:os 스튜디오 앱 마케팅. 모든 영상은 시청자가 원하는 작업을 실제 앱이 수행하는 모습을 보여줍니다(하나의 기능, 하나의 명확한 약속, 하나의 행동 촉구). 앱이 주인공이어야 하며, 편집 기술이 주인공이 되어서는 안 됩니다.

고정 템플릿이 아닙니다. 모든 영상은 이전 영상과 완전히 달라야 합니다: 새로운 아이디어, 새로운 기능 또는 작업, 새로운 영상, 새로운 구조, 새로운 팔레트와 배경, 새로운 움직임 언어, 새로운 음악. 창의성은 첫 3초 안에 돋보여야 합니다. 계획을 세우기 전에 프로젝트(orca-briefs/*designos*)에 있는 이전 브리프를 읽고, 그중 아무도 사용하지 않은 선택지를 고르세요. 그 선택지를 새 브리프에 기록하여 다음 영상이 이를 피할 수 있게 하세요. (engine/ideate.py, engine/music.py, references/creative-brief.md가 이를 도와줍니다.) spec/design-in-4-4.spec.json은 단 하나의 작업 예시일 뿐입니다(해당 영상은 오래되었으니 절대 재사용하지 말고 항상 새 영상을 녹화하세요).

하나의 spec JSON이 모든 것을 제어합니다: 비디오(render.py), 오디오(audio.py), 검증(beatlib.validate, qa.py). 새 영상 = 새로운 spec + 새로운 원본 테이크. 코드 변경은 없습니다.

일괄 생성: python engine/ideate.py batch --count 30 --seed N --out batch/ 명령으로 N개의 다른 계획(스타일, BPM, 콘셉트, 팔레트, 구조, 편집, 길이, 기능)과 manifest.json을 만듭니다. references/chatgpt-instructions.md를 참조하세요.

엄격한 규칙

모든 영상은 실제 design:os 스튜디오 앱(Openscreen --window "design:os studio")에서 새로 녹화된 것이어야 합니다. 모형, 다른 앱, 오래된 테이크는 사용할 수 없습니다.

파이프라인

  1. python engine/ideate.py plan --edits N --seed <new> --out plan.json → 콘셉트, 음악 스타일 + BPM, 팔레트, 구조, 각 편집이 위치할 지점을 생성합니다. 카피는 직접 작성하세요. 녹화 후: ideate.py build plan.json times.json --out spec.json. 음악: 5가지 생성 스타일(하우스, 로파이, 트랩, 신스웨이브, 시네마틱) 중 선택하며, spec.music에 설정합니다.
  2. 녹화: 앱의 실제 영상을 녹화합니다(Openscreen, --window "design:os studio", 커서 편집 가능 오버레이). 규칙: 클릭, 약 0.8초 멈춤, 그 다음 타이핑. 전체 앱을 보여줍니다. 사람 같은 커서. 동작보다 조금 더 길게 녹화합니다.
  3. Spec 작성 (spec/design-in-4-4.spec.json이 작업 예시이며, 필드는 references/spec-fields.md에 설명됨). 각 편집마다 원본 영상의 시간만 필요합니다: tc (커서가 사이드바를 클릭하기 시작하는 시간), hit (화면이 변경되는 시간), td (텍스트를 더블클릭하는 시간), ts/te (첫 번째/마지막 문자 입력 시간), 그리고 T = 편집이 위치할 비디오 시간(초) 단위의 마디선.
  4. python engine/run.py validate spec.json - 편집이 마디선에서 벗어나거나, 타이핑이 16분음표 그리드를 벗어나거나, 클릭-텍스트 간 멈춤이 너무 짧거나, 장면이 타임라인을 채우지 않으면 실패합니다.
  5. python engine/run.py all spec.json --root <원본 영상이 있는 디렉토리> --out <출력 디렉토리> → final.mp4 (1920x1080, 30fps, AAC)를 생성하고 qa.py를 실행합니다. 부분 실행: render F N (장면), audio, mux, qa.
  6. 전달하기 전에 3-4개의 프레임과 콘택트 시트를 확인합니다. Nam이 직접 게시하며, 절대 대신 게시하지 마세요.

가드레일 (마케팅 본부)

무료(FREE), "소스 사용 가능(source-available)"이라고 말하고 (절대 "오픈소스"라고 하지 않음), "Figma 킬러"라고 하지 않음, "개발자 뷰"라고 하지 않음, 출시된 기능만 사용, 모든 주장은 실제 영상으로 뒷받침. 영상은 제작 과정이 아니라 제품에 관한 것입니다.

작동 원리

영상 시간은 앵커(beatlib.Timeline.anchors)에 의해 비디오 시간에 매핑되므로, 어떤 속도로 녹화되었든 클릭이 마디선에 맞춰집니다. 120 BPM: 비트 0.5초, 마디 2초, 한 글자 입력 = 0.125초.

검증 완료

Spec에서 다시 렌더링된 장면 F는 원본과 프레임이 동일합니다(PSNR inf). 오디오 WAV는 바이트 단위로 동일합니다. 기본 피크 0.89는 샘플에서 +0.7 dBFS true peak를 제공했습니다. 새 영상의 경우 audio.peak를 약 0.8로 설정하세요.

요구 사항

python3, numpy, Pillow, ffmpeg/ffprobe; macOS 폰트(HelveticaNeue.ttc, SFNSMono.ttf) 또는 spec에서 fonts를 편집. legacy/design-in-4-4/에는 참고용 원본 스크립트(tl.py, make8.py, audio9.py, cursor2.py)가 보관되어 있습니다.

Prompt Motion: 모든 영상에 사용할 것

Prompt Motion Bridge 도구(Prompt_Motion_Bridge__recommend_motion_references, search_motion_references, get_motion_reference)는 모션 아이디어의 원천입니다. 모든 영상에 대해:

  • 각 장면(훅, 챕터 카드, 전환, 콜아웃, 캡션, 통계/요약, 엔드 카드)을 설명하고 레퍼런스를 요청하세요. 매번 새로운 키워드(kinetic type, mask reveal, morph, parallax, split-screen, glitch, liquid, stagger, counter, 3D tilt 등)로 검색하세요.
  • 영상당 최소 5개의 다른 레퍼런스를 선택하여 코드(PIL/numpy/ffmpeg 또는 Remotion)로 구현하세요. 브리프에 레퍼런스 ID를 기록하고 이전 영상과 동일한 세트를 재사용하지 마세요.
  • 밝고, 많은 애니메이션을 사용하되 앱 영상이 주인공으로서 읽기 쉬운 상태를 유지하세요.

장편 튜토리얼 (3-5분, 베트남어 음성 해설, YouTube)

첫 번째 영상은 2026-11-16에 Nam이 승인했습니다(final_v3.mp4, 4:21: .fig 템플릿에서 데스크탑+모바일 화면까지 6단계 과정). 예시로만 취급하세요: 다음 장편 영상은 다른 주제, 영상, 구조, 디자인이 필요합니다. 시작 코드: 이 스킬의 longform/ 디렉토리(Mac에서도 longform/에 있음): README.md, script2.py, gen_tts.py, lib.py, build.py, audio.py. 새 워크스페이스에 복사하여 변경하세요: 챕터, 레이아웃, 카드 및 캡션 디자인, 배경, 팔레트, 모션(Prompt Motion 활용), 음악 스타일과 템포. 절대 동일한 디자인을 두 번 사용하지 마세요.

아이디어: 각 영상은 자신만의 각도와 형식을 선택합니다. 예: 타이머에 도전, 전후 비교, 하나의 기능 심층 분석, "초보자가 자주 하는 3가지 실수", 실제 같은 화면 리디자인, 미니 디자인 시스템 구축, 모바일 우선, 스피드 런, Q&A. 모든 챕터는 시청자가 원하는 것을 보여줘야 합니다. "내가 한 실수"만을 다루는 챕터는 관련성 없다고 거부되었습니다. 출시된 기능만 사용하세요. 기능을 약속하기 전에 앱에서 확인하세요(오른쪽 상단의 Play 미리보기 ▷가 잘 작동합니다).

영상: 매 영상마다 Openscreen으로 새로 녹화하세요(다른 템플릿이나 파일, 다른 화면, 다른 편집). Openscreen은 앱 창만 녹화하며, 네이티브 macOS 대화상자는 녹화하지 않습니다: 파일 선택기는 텍스트 콜아웃으로 표시하고, 모형은 절대 사용하지 마세요. 레이어 패널에서 텍스트 레이어를 선택하고 Return 키를 누른 후 텍스트가 강조 표시되었는지 확인한 다음 타이핑하세요. 포커스되지 않은 필드에 타이핑하면 단축키가 실행될 수 있습니다. 음성 해설이 편집을 언급하기 전에 앱 상태를 다시 확인하세요(한 번 실행 취소가 버튼 텍스트를 조용히 되돌린 적이 있습니다).

음성 (Nam 승인): VieNeu-TTS v3 Turbo, 프리셋 "Hải Đăng". Mac에서 실행됩니다(.venv-voice/bin/python, gen_tts.py). 48kHz, 실시간의 약 0.3배 속도. Jang의 음성을 그의 서면 허락 없이 복제하지 마세요.

  • 문장 단위로 생성하고 문장 사이에 정확히 0.18초의 무음을 넣습니다. 캡션은 그 간격을 기준으로 시간이 지정되므로, 표시 텍스트와 TTS 텍스트의 문장 수가 동일해야 합니다.
  • 두 가지 텍스트를 유지하세요: 표시용(캡션, 올바른 철자)과 TTS용(재철자). 승인된 예: "Design OS Studio" -> "Đi-giai Âu-ét Studio" ("Studio"는 영어 유지), "Figma" -> "Phích-ma", ".fig" -> "phích", "megabyte" -> "mê-ga-bai". 절대 "DESIGN OS"를 모두 대문자로 쓰지 마세요(한 글자씩 발음됨).
  • Nam은 잘못된 영어 발음을 거부합니다: UI 단어는 베트남어로 말하세요(bảng lớp, vùng vẽ, bảng thuộc tính, phím xuống dòng, phím thoát, màu nền). 영어 UI 문자열은 콜아웃에만 사용하세요.
  • 새로운 재철자: 5-7개 변형을 시도하고, faster-whisper(vi 및 en)로 확인한 후 Nam에게 짧은 샘플 WAV를 보내고, 그의 승인 후에만 다시 빌드하세요.

화면 규칙: 1920x1080, 30fps. Openscreen 원본은 너비가 1600px에 불과하므로 카메라 줌을 약 1.6배 이하로 유지하세요(더 높으면 YouTube에서 흐려 보임). 모든 텍스트를 카드 안에 맞추고(자동 축소) 요약/통계 프레임에서 오버플로가 없는지 확인하세요. 엔드 카드는 전체 URL https://jangtrinh.github.io/design-os-studio/ 를 8-10초 동안 크게 표시하고 "소스 사용 가능 · Figma와 관련 없음"을 함께 표시합니다.

전달: 1080p와 함께 4K 업스케일(lanczos, crf 16)을 내보냅니다. YouTube용으로 4K를 보내되, ffprobe가 전체 재생 시간을 읽은 후에만 보내세요. Nam에게 YouTube에서 2160p가 표시될 때까지 업로드를 비공개로 유지하라고 알리세요. 하나의 명확한 제목 제안과 챕터 타임스탬프, 링크, 템플릿 크레딧 및 "Figma와 관련 없음"이 포함된 설명을 제공하세요. 절대 게시하지 마세요. Jang이 최종 승인합니다.

이 번들의 참고 파일

  • references/openscreen.md + tools/record.sh: 정확한 Openscreen 명령, 테이크 저장 위치, cursor.json 형식, 화면 매핑.
  • references/voice.md + longform/gen_tts.py + longform/check_voice.py: 승인된 음성, 설치 방법, 재철자 표, Whisper 확인.
  • references/prompt-motion.md: Prompt Motion 도구 사용법, 이미 사용된 레퍼런스, MCP 없을 때의 대체 방법.
  • references/chatgpt-instructions.md: ChatGPT/ORCA/Codex를 위한 핸드오프, 현재 장편 모드 포함.
  • longform/: 장편 영상용 시작 엔진 (ROOT=<workspace> python build.py info|agenda|<chapter>, python audio.py).

관련 스킬