Communitygithub.com

비디오-음악-편집-브이로그

일상, 여행, 음식, 하루 업무 등 다양한 클립을 음악 비트에 맞춰 자르고 연결해 TikTok/Reels 세로형 영상으로 즉시 게시 가능하게 만듭니다. 아름다운 장면을 선택하고 각 장면이 비트에 맞춰 전환되며 짧은 자막을 추가합니다.

비디오-음악-편집-브이로그란 무엇인가요?

이 스킬은 사용자가 여러 개의 클립을 가지고 '영상으로 만들어줘', '브이로그 만들어줘', '음악에 맞춰 영상 만들어줘' 등과 같은 요청을 할 때, 음악 비트에 맞춰 자른 세로형 쇼트 비디오를 자동으로 생성해주는 Agent Boss 전문 스킬입니다. 일상, 여행, 음식, 공간, 하루 업무 등 말이 없는 클립에 최적화되어 있으며, 중요한 대화가 포함된 영상에는 적합하지 않습니다 (대신 `video-phu-de-to` 스킬 권장). 이 스킬은 대상 플랫폼(예: TikTok, Instagram Reels)에 맞춰 9:16 세로 비율로 8~15개의 가장 아름다운 장면을 선택하고, 각 장면을 음악 비트에 정확히 맞춰 전환시킵니다. 또한 브랜드 프로필(로고, 색상, 폰트, 배경 음악)을 설정할 수 있으며, 짧은 제목(`mo_dau`)과 감성적인 안내 문구(`dan_chuyen`)를 추가하고, 자동 검사 절차를 통해 완성된 영상의 품질을 확인한 후 최종 결과물과 함께 게시용 설명글을 제공합니다. 스킬은 파이썬 스크립트(`kiem_tra.py`, `phan_tich.py`, `dung.py`)로 구성되어 있으며, 초기 환경 검사, 영상 분석, 편집 계획 수립, 최종 렌더링 단계를 거쳐 동작합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AgentBossVn/agent-boss-skills/tree/HEAD/video-ghep-nhac-vlog

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

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

문서

비디오 음악 편집 / 브이로그

적합: 일상, 여행, 음식, 공간, 카페 뒷이야기, '나의 하루' 등. 부적합: 중요한 대화가 포함된 영상 (대신 video-phu-de-to 사용).

공식 (10–30초)

  1. 음악은 필수: 사용자가 사용 권한이 있는 음악 파일이 필요합니다 (브랜드 프로필 또는 별도 요청). 비트가 뚜렷한 음악이면 컷이 더 잘 맞습니다. 음악이 없는 경우 → 사용자에게 알리고, 무료 저작권 라이브러리에서 음악을 가져오거나 TikTok 앱에서 게시 후 음악을 추가하도록 권장합니다 (이 경우 음악 없이 편집하며, 각 장면을 1.5~2초로 균일하게 설정).
  2. 장면 선택: 815개 구간, 각 구간에서 가장 예쁜 부분 약 3초 추출 (스킬이 자동으로 비트에 맞춰 0.82.6초로 조정). 가장 인상적인 장면을 맨 앞에 배치; 와이드-클로즈업 혼합; 마지막 장면은 '마무리' 장면 (석양, 미소, 완성된 요리).
  3. 자막: mo_dau 02.5초는 짧은 제목 ("1 DAY IN DALAT", "거리 속 작은 카페"). dan_chuyen 24개의 작은 안내 문장, 각 2~3초, 감성적인 소문자. 자막은 최소화하여 화면이 말하게 합니다.
  4. 원음: 끄기. 엔딩 카드: 끄기 (브이로그는 카드보다 예쁜 장면으로 마무리).

이 스킬의 자막 스타일

스타일용도위치
mo_dau제목중앙, 큰 글씨
dan_chuyen안내 문장하단, 작은 글씨

공통 절차 (모든 영상 유형)

모든 명령은 이 스킬의 디렉토리(SKILL.md 파일이 있는 디렉토리)에서 실행됩니다. <SKILL>은 해당 디렉토리 경로를 나타냅니다.

단계 0. 환경 확인 (매 사용 시)

파이썬 명령: macOS는 python3, Windows는 py -3 ( python만 입력하지 마세요: Windows 최신 버전은 Microsoft Store의 가짜 버전일 수 있습니다). 경로는 / 사용, Git Bash와 PowerShell 모두에서 실행 가능. 아래는 python3로 표기하며, Windows에서는 py -3으로 대체하세요.

python3 <SKILL>/scripts/kiem_tra.py
  • thieu_bat_buoc가 비어 있지 않으면 → 사용자에게 설치할 목록을 보여주고 한 문장으로 "이것들을 설치하시겠습니까?" 물어본 후 동의하면 실행. Windows에 Python이 없는 경우: winget install -e --id Python.Python.3.12 --scope user. Windows에서 ffmpeg 설치 후 명령 창을 다시 열거나 (또는 Agent를 재시작) 해야 ffmpeg 명령을 인식합니다.
  • thieu_tuy_chon → 필요한 경우에만 설치: faster-whisper (음성 자막용, 처음 실행 시 약 800MB 모델 다운로드), edge-tts (AI 음성용).
  • cap_nhat.co_ban_moi가 true이면 → 한 문장으로 "이 스킬의 새 버전 {moi_nhat}이 있습니다. 업데이트하시겠습니까?" 알림. 사용자가 동의하면 cau_cap_nhat에 기록된 작업을 정확히 수행. 자동 업데이트 금지. cap_nhat이 null이면 무시하고 정상 편집 진행.
  • cap_nhat.skill_khac_chua_cai에 이름이 있으면 → 답변 마지막에 한 줄로 "Agent Boss 창고에는 또한: …" 알림. 세션당 한 번만 알림.
  • 폰트: 자모 오류나 보기 나쁠 경우 python3 <SKILL>/scripts/kiem_tra.py --cai-font 실행 (Google Fonts에서 Be Vietnam Pro 다운로드).

단계 1. 브랜드 프로필 (최초 한 번)

~/.agent-boss/thuong-hieu.json 읽기 (모든 Agent Boss 스킬 공용). 없으면 사용자에게 한 메시지로 간결하게 질문: 상점/채널명, 영상 마지막 콜투액션, 주요 색상, 강조 색상, 로고 경로 (있는 경우), 사용 권한이 있는 배경 음악 파일 (있는 경우). 생략하는 항목은 기본값 사용. 파일 저장:

{"ten": "구름 카페", "cau_ket": "지금 장바구니에 담으세요", "mau_chinh": "#1B1B1B", "mau_nhan": "#FFD21F",
 "mau_chu": "#FFFFFF", "logo": "~/Pictures/logo.png", "font": null, "nhac": "~/Music/nen.mp3"}

이 파일은 스킬 디렉토리 외부에 있으므로 스킬 업데이트 시에도 유지됩니다.

단계 2. 입력 영상 확인

python3 <SKILL>/scripts/phan_tich.py <영상 또는 영상 디렉토리> --ra <작업-디렉토리>

작업 디렉토리: 사용자 영상 옆에 video-<날짜>-<짧은-이름>/ 생성. 각 영상에 대해 phan-tich/<이름>.json 읽기 (길이, 세로/가로, 무음 구간, 장면 전환 지점, 음성 텍스트) 및 사진 phan-tich/<이름>.jpg 열어보기 (초 단위 프레임 그리드)로 예쁜 구간 선택. 음성이 없는 영상은 --khong-nghe 추가하여 빠르게 처리.

단계 3. 계획 ke-hoach.json 작성 (작업 디렉토리 내)

{
  "dau_ra": "thanh-pham/video.mp4",
  "doan": [{"file": "../clip1.mp4", "tu": 2.0, "den": 9.5}],
  "chu": [{"tu": 0, "den": 2.6, "noi_dung": "프라이팬 사기 전에 꼭 보세요", "kieu": "mo_dau"}],
  "giong_doc": null,
  "nhac": null,
  "sua_chu": {"cờ lốt": "Claude"},
  "tu_khoa": ["할인", "무료"],
  "the_ket": true
}
  • doan: 원본 영상의 초 단위, 나타날 순서대로. 경로는 ke-hoach.json이 있는 디렉토리 기준.
  • chu: 새 영상의 초 단위. "den": "het"는 본문 끝까지. kieu는 이 스킬의 자막 스타일 표 참조.
  • giong_doc: {"van_ban": "...", "giong": "ko-KR-SunHiNeural"} (여성) 또는 ko-KR-InJoonNeural (남성). 대화체로 짧은 문장 작성. 초당 약 3.5자.
  • nhac: 비우면 브랜드 프로필의 음악 사용; 없으면 배경 음악 없음. 사용자가 사용 권한이 있는 음악만 사용. 영상에 이미 음악이 있으면 "nhac": null로 설정.
  • sua_chu: 음성 인식이 잘못 인식한 단어 (고유명사, 제품명, 영어 단어)를 여기서 수정. 분석 결과의 van_ban을 주의 깊게 읽어 오류 확인.

새 영상에서 각 자막 구간의 정확한 시간을 알고 싶다면 (자막을 음성과 동기화하기 위해): python3 <SKILL>/scripts/dung.py ke-hoach.json --chi-thoi-gian.

단계 4. 렌더링

python3 <SKILL>/scripts/dung.py <작업-디렉토리>/ke-hoach.json

thanh-pham/video.mp4 (1080×1920, 30fps, 오디오 표준 −14 LUFS) 및 thanh-pham/video-bia.jpg 출력.

단계 5. 자체 검토 후 전달

  1. ffmpeg로 3개 프레임 (처음, 중간, 끝) 추출하여 확인: 자막이 화면 가장자리를 넘거나, 얼굴을 가리거나, 오타가 없는지 확인. 오류가 있으면 계획 수정 후 재렌더링.
  2. thanh-pham/chu-thich.txt 작성: 호기심을 자극하는 첫 문장 1개 + 내용 23줄 + 콜투액션 + 주제와 밀접한 베트남어 해시태그 46개 (일반적인 해시태그 남발 금지).
  3. 사용자에게 알림: 영상 경로, 표지 이미지, 설명글. 수정할 사항이 있는지 질문 (첫 문장 변경, 더 짧게, 음악 변경 등).

공통 규칙

  • 세로 영상 9:16. 자막은 TikTok 안전 영역 내: 오른쪽 가장자리 (버튼 열)에 닿지 않도록, 높이 80% 이하로 내려가지 않도록 (채널명, 설명글 위치).
  • 처음 3초가 시청자 이탈 여부를 결정합니다. 항상 명확한 첫 문장이 있어야 합니다.
  • 허위 약속 금지, "100% 보장", "치료", "최고" 등의 표현 금지 (화장품, 건강기능식품, 의약품의 경우 TikTok에서 제한 또는 광고 거절 가능).
  • 사용자가 사용 권한이 없는 음악, 이미지, 로고 사용 금지.

Individual skills in this repo

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

관련 스킬