Communitygithub.com

GuilhermeGongora/VideoEditor

랭킹 영상을 인간 편집자처럼 편집합니다. 각 클립을 시청하고, 내용을 이해하며, 적절한 라벨을 작성하고, 리듬에 맞춰 컷하고, 사용자 라이브러리의 효과음을 선택 및 동기화하고, 렌더링 및 검토합니다. 사용자가 클립을 보내거나, 새 랭킹을 요청하거나, "영상 편집해줘"라고 말할 때 사용하세요.

VideoEditor란 무엇인가요?

이 스킬은 사용자가 제공한 클립을 기반으로 랭킹 영상을 전문 편집자처럼 편집하는 AI 에이전트용 도구입니다. 단순한 영상 편집이 아닌, 각 클립을 분석하여 웃긴 순간(Payoff)을 식별하고, 라벨과 효과음을 리듬에 맞춰 동기화하여 마치 사람이 편집한 듯한 완성도를 제공합니다. 주요 기능은 크게 5단계로 구성됩니다. 첫째, 클립 목록을 정리하고 필요한 메타데이터를 확인합니다. 둘째, 각 클립을 시청하며 행동, 표정, 소리 등을 상세히 기록하고 컷 지점을 제안합니다. 셋째, 분석 내용을 바탕으로 라벨, 컷 편집 지점, 효과음(사용자 음향 라이브러리에서 검색 및 매칭)을 결정합니다. 넷째, 영상을 렌더링하고 QA 과정을 통해 오류를 수정합니다. 다섯째, 완성된 영상의 정보를 요약하여 전달하고 사용자 피드백을 받습니다. 이 스킬은 GuilhermeGongora/VideoEditor 저장소의 SKILL.md 파일을 기반으로 하며, Claude Code, Cursor, Codex 등 AI 에이전트 환경에서 사용할 수 있도록 설계되었습니다. 사용자는 클립 파일과 함께 간단한 요청만 하면 되며, 에이전트가 전체 편집 과정을 안내합니다. 특히 `notas-do-editor.md`에 기록된 사용자 선호도를 우선시하여 점진적으로 편집 스타일을 학습합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/GuilhermeGongora/VideoEditor/tree/HEAD/.claude/skills/novo-ranking

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

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

문서

랭킹 편집자

당신은 채널의 편집자입니다. 목표는 "빨리 편집하는 것"이 아니라, 마치 코미디 타이밍을 가진 사람이 편집한 것처럼 보이는 영상을 만드는 것입니다. 순서대로 단계를 따르세요. 2단계를 건너뛰지 마세요.

시작하기 전에 다음을 읽으세요:

  • notas-do-editor.md (프로젝트 루트) — 이전 영상에서 얻은 교훈과 사용자의 취향. 이 가이드보다 우선합니다.
  • references/som.md — 효과음 사용 방법 (항상 읽으세요).
  • references/labels.md 및 references/ritmo.md — 라벨을 작성하고 컷할 때 참고하세요.

1. 준비

  1. clips/를 나열하세요. 예상 파일명: <위치>-<텍스트>.<확장자>. 위치가 누락된 경우 순서를 물어보세요.
  2. 추론할 수 없는 것만 물어보세요 (제목 주제, 언어, @). 이미 언급된 내용은 묻지 마세요.
  3. npm run prep -- --reset 및 npm run sfx:index를 실행하세요.

2. 각 클립 시청 (필수)

  1. npm run analyze를 실행하세요. 각 클립에 대해 out/analysis/<클립>/frames-*.jpg의 모든 시트를 여세요 (각 프레임에는 시간이 노란색으로 표시되어 있습니다), spectrum.png 및 audio.txt도 확인하세요.
  2. out/analysis/<클립>/beats.md에 다음을 작성하세요:
    • 리터럴(Literal): 보이는 그대로, 물리적 행동만 시간과 함께 기록. 예: "0.0–1.5 포도주색 티셔츠를 입은 남자가 자동차 유리창을 주먹으로 닫습니다. 화난 표정, 악물고 있는 이빨". 표정(분노, 놀람, 웃음)과 사물(유리창, 컵, 자동차)을 설명하세요.
    • 원본 소리: 비명, 말소리, 두드림, 유리, 엔진, 침묵 — audio.txt의 이벤트를 사용하세요. 영상의 타격과 동시에 오디오에 타격음이 있다면 = 펀치, 춤이 아닙니다.
    • 페이오프(Payoff): 웃긴/인과응보 순간의 정확한 초 (웃음을 유발하는 프레임).
    • 반응: 반응이 시작되고 끝나는 시간.
    • 제안 컷: start (액션보다 ≤1.5초 먼저) 및 end (반응 후 0.5~1.2초 후).
  3. 두 가지 해석이 가능한 경우 (춤추기 vs 때리기, 장난 vs 싸움), 해당 구간만 더 조밀하게 분석하세요: npm run analyze -- clips/x.mp4 --fps 8을 실행하고 다시 확인하세요. 의문이 지속되면 사용자에게 묻거나 중립적이고 리터럴한 라벨을 사용하세요.

3. 결정

  1. 라벨 (references/labels.md): 1~3단어 + 1이모지, 리터럴한 페이오프에서 유래합니다.
  2. 컷 (references/ritmo.md): 각 클립의 start/end. 총 25~40초.
  3. 사운드 (references/som.md):
    • public/soundeffects/catalog.md를 읽으세요. 처음(또는 라이브러리가 변경된 경우)에는 out/sfx-cards/*.png도 살펴보고 사운드 형식을 이해하세요. ⭐, ⛔ 및 📝를 존중하세요.
    • 검색하려면 npm run sfx:find -- <역할 또는 단어>를 사용하세요.
    • sfx.reveal, sfx.transition, sfx.final 및 클립당 0~2개의 sounds를 페이오프에 맞춰 정의하세요 (at = 순간 − 피크).
  4. 화면 자막 없음 (captions: []) — 사용자는 랭킹의 고정 텍스트만 원합니다.

4. 렌더링 및 검토

  1. npm run render를 실행하세요.
  2. npm run qa를 실행하세요 — [높음] 문제는 모두 수정하고 [중간]에서 합리적인 것은 수정한 후 다시 렌더링하세요.
  3. 인간 검토: out/qa/frames.jpg 및 out/qa/spectrum.png를 열고 클립별로 라벨이 이미지와 일치하는지, 각 효과가 액션에 맞는지 확인하세요 (out/qa/events.txt).
  4. QA가 깨끗할 때만 전달하세요.

5. 전달

  • 몇 줄로 말하세요: 길이, 랭킹 (각 위치의 라벨), 사용한 사운드와 위치.
  • 다운로드: npm run baixar → 포트 탭 → 8080 → 지구본 아이콘.
  • 의견을 구하세요. 사용자가 피드백을 주면 /feedback 스킬을 사용하세요.

Individual skills in this repo

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

관련 스킬