Communitygithub.com

utillayer/youtube-agent-skill

녹음 파일의 대본을 데드 에어, 필러 단어 실수 및 재촬영 구간을 시간 코드와 함께 편집 결정 목록으로 변환합니다. "이 부분 편집해", "정적 제거", "영상 간추려", "내가 횡설수설했어" 또는 대본을 기반으로 영상 길이를 줄이고자 하는 모든 요청에 사용하세요.

youtube-agent-skill란 무엇인가요?

이 스킬은 타임스탬프가 포함된 대본(예: SRT, VTT, Whisper JSON)을 분석하여 편집 결정 목록(EDL)을 생성합니다. 데드 에어(침묵 구간), 필러 단어(음, 그게, basically 등), 반복된 문장(재시도)을 탐지하고 시간 코드를 함께 출력합니다. 최종 편집은 사용자가 결정하며, 이 스킬은 분석 결과를 제공할 뿐 미디어를 직접 수정하지 않습니다. Claude Code, Cursor, Codex, claude.ai 등 다양한 플랫폼에서 사용할 수 있으며, Python 스크립트를 통해 실행됩니다. 대본이 없는 경우 yt-dlp를 사용하여 YouTube 자막을 다운로드하거나 Whisper로 음성을 전사하는 것을 권장합니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/utillayer/youtube-agent-skill/tree/HEAD/skills/yt-edit

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

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

문서

yt-edit

타임스탬프가 있는 대본에서 추출한 편집 결정 목록입니다. 컷 포인트를 출력하면 사용자가 직접 적용합니다.

python3 ${CLAUDE_SKILL_DIR}/deadair.py transcript.srt              # srt, vtt 또는 whisper json
python3 ${CLAUDE_SKILL_DIR}/deadair.py transcript.srt --floor 0.35 --json

도구는 이 스킬의 폴더에 있습니다. ${CLAUDE_SKILL_DIR}는 Claude Code에서 해당 폴더를 가리킵니다. Claude.ai나 Codex처럼 확장되지 않는 환경에서는 이 SKILL.md가 로드된 폴더를 직접 사용하세요.

아직 대본이 없나요? 먼저 대본을 요청하거나 직접 생성하세요. whisper, faster-whisper, 또는 YouTube가 비공개 업로드에서 생성하는 자막 트랙 모두 작동합니다. YouTube의 자동 자막 .vtt 파일은 그대로 사용 가능합니다. 로드 시 인라인 단어 시간, 반복되는 줄, [Music] 스타일 주석은 자동으로 제거됩니다. 시간을 추측하지 마세요.

링크는 있지만 대본이 없나요? YouTube 자체 자막을 한 줄로 가져올 수 있습니다:

yt-dlp --skip-download --write-auto-subs --sub-langs en --sub-format vtt -o transcript "<video url>"

위 명령은 transcript.en.vtt 파일을 생성합니다. en을 해당 동영상의 언어 코드로 바꾸세요. 자동 자막에는 구두점이 없지만, whisper 대본에는 구두점이 있어 더 깔끔한 문장 경계를 제공합니다.

찾아내는 항목

  • 데드 에어 (DEAD) - 기준 시간(floor)보다 긴 공백 구간. 중간에서 잘라내어 양쪽에 숨 쉴 여백을 남깁니다. 말에 딱 붙여 자르면 영상이 숨 가쁘게 보입니다.
  • 필러 (FILLER) - "음", "그게", "사실은", "basically" 같은 단어만 있는 큐. 스페인어("bueno", "o sea"), 힌디어("matlab", "accha", "मतलब"), 네팔어("ani", "khai", "अनि")도 지원합니다. 다른 언어는 DEAD와 REPEAT만 찾고 필러 목록은 생성하지 않습니다. 이를 사용자에게 알려주세요.
  • 반복 (REPEAT) - 다시 시작된 문장. 직전 큐가 아닌 마지막 실제 발화 큐와 비교합니다. 대부분의 재촬영은 두 시도 사이에 "음"이 끼어 있기 때문입니다. 포기한 테이크(대개 더 짧은 쪽)가 잘립니다.

하지 않는 작업

이 스킬은 미디어 파일을 건드리지 않습니다. B-롤(보조 영상)에 대해 의견을 제시하지 않습니다. 보고서에 40% 컷이 표시되면 이는 발화의 40% 컷이며, 영상에 긴 무음 데모가 포함된 경우 실제 실행 시간이 다를 수 있습니다. 보고서를 푸티지와 대조하여 맨 아래의 실행 시간을 신뢰하기 전에 확인하세요.

게이트 (최종 결정)

이 스킬은 아무것도 게시하지 않습니다. 스킬은 분석 결과를 작성하고 사용자가 게시합니다. 모든 출력은 사용자가 복사하는 블록으로 끝나며, 매 실행의 마지막 줄은 질문입니다: 배포할까요, 아니면 수정할까요?

Individual skills in this repo

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

관련 스킬