본문으로 건너뛰기

YouTube Transcript 스킬

사용 가능한 자막을 받고 없으면 선택적으로 음성을 전사합니다.

커뮤니티 · michalparkola
작성자michalparkola
라이선스MIT
소스michalparkola/tapestry-skills · GitHub의 SKILL.md
작동 환경Claude Code · Codex, Gemini CLI, Cursor, Copilot
소스 확인 날짜

youtube-transcript는 yt-dlp로 자막을 받습니다.

수동 자막, 자동 자막 순으로 우선하며 Whisper는 선택적 최후 수단입니다.

스킬의 SKILL.md에서: # YouTube Transcript Downloader

michalparkola의 커뮤니티 스킬로, 저희나 Anthropic이 검토하지 않았습니다. 스킬은 에이전트에게 코드 실행, 파일 읽기, 네트워크 호출을 지시할 수 있습니다. 설치하기 전에 SKILL.md와 폴더 안의 모든 스크립트를 읽고, 설명과 맞지 않는 동작이 없는지 확인하세요.

하는 일

  1. 자막 목록을 보고 트랙을 받은 뒤 필요하면 VTT를 정리합니다.

얻을 수 있는 결과물

  • 자막 파일 또는 중복을 제거한 텍스트.

이럴 때 사용하세요

  • 영상 발화를 읽거나 인용하기.

이럴 때는 맞지 않습니다

  • 모든 영상에 접근 가능한 자막이 있다고 가정하는 경우.

필요한 것

  • 네트워크와 yt-dlp. 선택적 전사는 Whisper, FFmpeg와 모델 저장 공간이 필요합니다.

스킬에 들어 있는 파일

파일 또는 폴더용도
SKILL.md자막 선택, 대체 전사와 정리 절차.

2026-11-16 기준 저장소에 있는 라이선스: MIT.

예시 프롬프트

설치한 뒤 아래 중 하나를 입력해 보세요. 스킬 이름을 넣으면 그 스킬이 확실히 사용됩니다.

  • 이 영상의 영어 자막을 받아 줘.
  • VTT를 읽기 쉬운 글로 바꿔 줘.
  • 받기 전에 자막 언어를 나열해 줘.

youtube-transcript 설치 방법

작업 환경 준비

yt-dlp를 별도 설치하세요. 대체 절차는 음성이나 모델 다운로드 전에 묻습니다. 인용용 시간 정보를 보존하세요.

yt-dlp --list-subs "YOUTUBE_URL"

스킬은 SKILL.md 파일이 든 폴더입니다. 한 번만 설치하면, 에이전트가 세션을 시작할 때마다 짧은 설명을 읽고 요청이 맞을 때만 전체 지침을 불러옵니다. 사용하는 곳을 고르세요.

Claude Code: 스킬 폴더에 복사

이 컴퓨터의 모든 프로젝트에서 쓰려면 스킬 폴더를 ~/.claude/skills/에 넣고, 저장소에서 함께 작업하는 모든 사람과 공유하려면 저장소 안의 .claude/skills/에 넣으세요(커밋하세요).

git clone --depth 1 https://github.com/michalparkola/tapestry-skills.git
mkdir -p ~/.claude/skills
cp -R tapestry-skills/youtube-transcript ~/.claude/skills/

Claude Code는 세션 중에도 이 폴더의 새 스킬이나 변경된 스킬을 알아챕니다. 세션을 시작할 때 skills 폴더가 없었다면 /reload-skills를 한 번 실행하세요. 그런 다음 /youtube-transcript를 입력하거나 작업을 설명하면 됩니다.

Windows에서는 Git Bash나 WSL에서 명령어를 실행하거나, 파일 탐색기로 같은 위치에 폴더를 복사하세요.

Codex, Gemini CLI, Cursor, GitHub Copilot

이 에이전트들은 같은 SKILL.md 폴더를 읽습니다. 네 가지 모두가 프로젝트 안에서 인식하는 폴더는 .agents/skills/이므로, 아래 명령은 스킬을 그곳에 복사합니다.

git clone --depth 1 https://github.com/michalparkola/tapestry-skills.git
mkdir -p .agents/skills
cp -R tapestry-skills/youtube-transcript .agents/skills/
에이전트프로젝트 폴더사용자 폴더참고
OpenAI Codex
.agents/skills/
~/.agents/skills/
$를 입력하거나 /skills를 실행해 스킬을 고르세요. 작업이 맞으면 Codex가 스스로 스킬을 고르기도 합니다.
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
또는 gemini skills install <git URL> --path <folder> --consent로 Git에서 설치하세요. Google은 2026년 6월 18일 무료 등급과 Google One 사용자의 Gemini CLI를 Antigravity CLI로 대체했습니다. Antigravity는 프로젝트에서는 .agents/skills/를, 사용자용으로는 ~/.gemini/config/skills/를 사용합니다.
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
Agent 채팅에서 /를 입력해 스킬을 고르세요. Cursor는 Claude Code의 .claude/skills/ 폴더도 읽습니다.
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
Copilot CLI, 클라우드 에이전트, 그리고 VS Code, Visual Studio, JetBrains의 에이전트 모드에서 작동합니다(IDE 지원은 버전에 따라 다름). 또는 gh skill install OWNER/REPOSITORY SKILL를 실행하세요(공개 프리뷰, GitHub CLI 2.90.0 이상).
신뢰할 수 있는 스킬만 설치하세요. Anthropic은 신뢰할 수 있는 출처의 스킬만 사용하고, 그 밖의 스킬은 사용하기 전에 모든 파일을 읽어 보라고 권합니다. 스킬은 설명에 나오지 않는 방식으로 에이전트에게 명령어 실행, 파일 읽기, 데이터 전송을 지시할 수 있기 때문입니다.

이 단계의 출처

2026-11-14에 각 업체의 문서와 대조해 확인했습니다:

사용 가능한 트랙 확인

목록으로 언어 코드를 추측하지 않고 사람 자막과 자동 전사를 구별합니다.

대체 작업 자원 고려

전사에는 음성, 디스크와 모델이 필요하며 추가 다운로드와 연산이 발생합니다.

youtube-transcript에 관한 질문

영상을 먼저 받나요?

영상 없이 자막만 받을 수 있습니다.

자막이 없으면요?

로컬 Whisper 전사를 제안할 수 있습니다.

자동 텍스트는 정확한가요?

아니요. 이름, 숫자와 인용을 검토하세요.

비공개 영상은 실패하나요?

예. 접근, 지역과 인증 제한은 그대로입니다.

더 많은 AI 스킬

관련 스킬

스킬 카테고리