Communitygithub.com

product-promo-from-repo

리포지토리의 소스 코드를 기반으로 소프트웨어 제품 홍보/런칭 영상(宣传片、产品介绍视频、功能演示片)을 준비합니다 — 스토리라인, 샷별 명세, MiniMax 내레이션(配音), 코드로 합성된 오리지널 음악, 프론트엔드 및 백엔드 코드를 HTML로 재구성한 제품 화면까지 포함합니다. 사용자가 '이 앱/프로젝트/리포지토리'에 대한 홍보 영상, 런칭 필름 또는 데모 비디오를 요청하거나 GitHub URL이나 로컬 프로젝트를 주며 '做个视频'라고 말할 때 사용하세요.

product-promo-from-repo란 무엇인가요?

이 스킬은 소프트웨어 제품의 소스 코드를 분석하여 전문적인 30~45초 분량의 홍보 영상을 제작합니다. 사용자가 GitHub URL 또는 로컬 리포지토리를 제공하고 비디오 제작을 요청하면, 이 스킬은 코드에서 내비게이션 구조, 작업 흐름, 백엔드 시드 데이터, 실제 제한 값 및 숫자 등 사실적인 정보를 수집합니다. 수집된 정보를 바탕으로 세 가지 스토리라인을 작성하고 사용자가 선택한 후, 선택된 스토리라인에 따라 MiniMax 음성 합성 API를 통해 내레이션을 생성하고, 코드 합성으로 오리지널 배경 음악을 만듭니다. 또한 앱을 실행하거나 모의 백엔드를 사용하지 않고, 프론트엔드와 백엔드 코드에서 직접 HTML로 제품 화면을 재구성합니다. 결과물은 정밀한 샷 목록(SPEC.md)과 리뷰 문서(REVIEW.md)를 포함하여 음악, 효과음, 내레이션이 동기화된 완전한 영상 사양을 제공합니다. 이 스킬은 Claude Code 환경에서 사용하도록 설계되었으며, Python, HTML/CSS, FFmpeg 등 명령줄 도구와 함께 작동합니다. 무료 도구를 선호하며, 구체적인 렌더링 엔진은 사용자와 협의하여 결정합니다.

지원 대상~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/rayest/ai-video-skills/tree/HEAD/skills/product-promo-from-repo

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

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

문서

리포지토리로부터의 제품 홍보 영상

30~45초 분량의 영화로, 한 명의 시청자가 제품에서 하나의 실제 작업을 수행하는 모습을 코드의 실제 레이블, 내레이션 및 오리지널 음악과 함께 보여줍니다. 이 스킬은 코드, 스토리, 음성, 음악 및 재구성된 화면에서 제품을 올바르게 얻는 모든 과정을 다룹니다. 렌더링 엔진을 규정하지 않습니다. 사용자와 함께 선택하십시오(무료 도구 선호).

1. 올바른 코드 읽기

  • 아무것도 읽기 전에 git fetch --all을 실행하고 브랜치를 비교합니다(git log -1 origin/<b> 각각에 대해). 기본 브랜치가 오래되었을 수 있습니다. — main이 초기 커밋인데 제품이 dev에서 이름이 바뀌고 재구축되었을 수 있습니다. 잘못된 브랜치에서 스토리라인을 작성하면 한 라운드를 완전히 낭비하게 됩니다. 사용자가 이름이나 기능이 변경되었다고 말하면 믿고 해당 브랜치를 찾으십시오(git grep -c <새 이름> origin/<b>).
  • 인상이 아닌 사실을 수집합니다: 내비게이션(제품이 수행하는 작업에 대한 자체 맵), 주요 작업 흐름의 페이지 구성 요소, 백엔드 시드 데이터의 카탈로그 이름, 실제 제한 및 숫자(최대 길이, '예상 초 = 글자 수 ÷ 4.5'와 같은 공식). 영화의 모든 주장은 이 중 하나로 추적 가능해야 합니다.
  • 리포지토리에서 로고와 썸네일/아이콘을 assets/로 복사합니다. 로고에 이전 브랜드 텍스트가 없는지 확인합니다.

2. 스토리라인 작성 후 일시 중지

세 가지 스토리라인을 STORYLINES.md에 작성하고(각각: 한 줄 개요, 시간이 포함된 비트 목록, 각 이음을 운반하는 전환) 사용자가 선택할 수 있도록 일시 중지합니다. 다단계 제품에 가장 효과적인 방법: 하나의 객체가 제품의 단계를 거쳐 이동(발견된 게시물 → 주제 카드 → 스크립트 → 완성된 비디오), 커서가 그것을 잡는 것으로 시작합니다. 추천하는 것을 먼저 넣으십시오.

가정을 한 줄로 명시하십시오: 길이 30~40초, 1920×1080, 음악 + 효과, 내레이션 예/아니오, 화면의 제품 데이터는 데모 데이터입니다.

3. 내레이션 (MiniMax)

요청받았을 때만 수행합니다. $MINIMAX_API_KEY 또는 ~/.minimax_key의 첫 번째 줄을 입력하십시오. 절대 출력하지 마십시오.

  1. 비트당 하나의 짧은 줄을 voice/script.json에 작성합니다([{"id", "text"}]). 초당 약 4.5 중국어 문자, 3540초 동안 약 120140자입니다. 줄은 원인과 결과여야 하며 슬로건이 아닙니다. 화면에는 키워드가 표시되고 음성 문장은 문자 그대로 표시되지 않습니다.
  2. 사용자에게 줄, 음성 ID 및 모델을 보여주고 승인을 받으십시오. 각 호출은 비용이 청구됩니다. python3 -I scripts/tts_minimax.py voice --dry-run은 문자 수와 예상 길이를 출력합니다.
  3. 한 번 생성: python3 -I scripts/tts_minimax.py voice [--voice ID] → vo-<id>.mp3 및 durations.json. 한 줄만 다시 생성하려면 --only id를 사용하십시오.
  4. 음성이 시계 역할을 합니다. durations.json에서 장면을 배치하십시오(각 줄은 해당 장면의 약 0.150.25초 지점에서 시작하며, 장면 ≈ 줄 + 0.30.6초).

4. 제품 화면: 코드에서 재구성

스크린샷을 위해 앱을 실행하거나 백엔드를 모킹하지 마십시오. 구성 요소, CSS 및 백엔드 데이터에서 HTML로 화면을 재구성하십시오. 첫 번째 제품 장면 전에 references/ui-redraw.md를 읽으십시오.

데모 데이터에 演示数据 · 虚构 레이블을 붙이십시오. 이전 제품 이름이나 로고를 절대 표시하지 말고, 코드에 없는 버튼을 절대 만들어내지 마십시오.

5. 음악 및 효과

  • scripts/score.py는 박자 그리드가 페이오프에 다운비트를 배치하고 로고 히트가 정수 비트 후에 오도록 하는 오리지널 트랙을 합성합니다(numpy + scipy 필요): score.py assets/bgm/score.wav --total 38.5 --bpm 104 --hook-end 4.6 --reveal 9.8 --build 24.2 --payoff 27.0 --claim 31.6 --logo-beats 13 --logo-beats는 payoff + beats × 60/bpm이 엔드 카드 마크가 떨어지는 지점에 도달하도록 선택하십시오.
  • 무료 소스의 효과(클릭, 윙, 팝, 타이핑, 라이저, 임팩트, 스파클). 보이는 원인당 하나의 사운드입니다.

6. 명세 및 검토

  • 장면 전에 SPEC.md를 작성하십시오: GOAL, OUTPUT, TIME, VOICE, DATA, LOOK, OBJECTS, MOTION, SHOTS(시간 포함), BANNED, QA 프레임.
  • 모든 비트와 이음을 확인하십시오: 움직임 방향이 반전되는 이음(오른쪽으로 떠나는 객체는 다음 장면에 오른쪽에서 들어와야 함), 요소가 착지하기 전에 페이드 아웃되는 부분, 히어로 프레임의 빈 절반을 수정하십시오.
  • REVIEW.md를 작성하십시오: 창의적 결정, 측정된 것과 단순히 본 것, 가장 약한 샷.
  • 최종 오디오: 약 -16 ~ -14 LUFS, 실제 피크 ≤ -1 dBTP, 클리핑 없음. 소리가 듣기보다 측정되었다고 명시하십시오.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬