Communitygithub.com

delorenj/skills

YouTube 영상 자막을 요약, 스레드, 블로그 등으로 변환합니다.

skills란 무엇인가요?

이 스킬은 사용자가 YouTube URL을 제공하거나 영상 요약, 자막(transcript) 추출, 콘텐츠 재구성을 요청할 때 활성화됩니다. `youtube-transcript-api` 라이브러리를 기반으로 자막을 가져온 후, 사용자의 요청에 따라 챕터 목록, 5~10문장 요약, 챕터별 요약, 트위터/X 스레드(280자 제한), 블로그 포스트, 타임스탬프 인용문 등 다양한 형식으로 변환합니다. Claude Code, Cursor, Codex 등 `uv` 패키지 관리자와 Hermes 환경을 지원하는 모든 AI 에이전트 플랫폼에서 동작합니다. 작업 흐름은 자막 추출 → 유효성 검사 → 필요시 청크 분할(40K자 단위, 2K 중첩) → 요청 형식으로 변환 → 최종 검증 순서로 이루어지며, 언어 대체(fallback), 오류 처리 등도 포함되어 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/delorenj/skills/tree/HEAD/youtube-content

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

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

문서

YouTube 콘텐츠 도구

사용 시점

사용자가 YouTube URL이나 동영상 링크를 공유하거나, 동영상 요약을 요청하거나, 자막을 요청하거나, YouTube 동영상의 콘텐츠를 추출하여 재구성하려고 할 때 사용합니다. 자막을 장별 요약, 요약문, 스레드, 블로그 게시물과 같은 구조화된 콘텐츠로 변환합니다.

YouTube 동영상에서 자막을 추출하여 유용한 형식으로 변환합니다.

설정

uv를 사용하여 의존성을 Hermes 관리 환경에 설치합니다:

uv pip install youtube-transcript-api

도우미 스크립트

SKILL_DIR은 이 SKILL.md 파일이 포함된 디렉터리입니다. 스크립트는 모든 표준 YouTube URL 형식, 짧은 링크(youtu.be), shorts, 임베드, 라이브 링크 또는 원시 11자 동영상 ID를 지원합니다.

# 메타데이터가 포함된 JSON 출력
uv run python3 SKILL_DIR/scripts/fetch_transcript.py "https://youtube.com/watch?v=VIDEO_ID"

# 일반 텍스트 (파이프를 통한 추가 처리에 적합)
uv run python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --text-only

# 타임스탬프 포함
uv run python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --timestamps

# 특정 언어 및 대체 언어 체인 지정
uv run python3 SKILL_DIR/scripts/fetch_transcript.py "URL" --language tr,en

출력 형식

자막을 가져온 후, 사용자가 요청한 내용에 따라 형식을 지정합니다:

  • 챕터(Chapters): 주제 전환별로 그룹화하여 타임스탬프가 있는 챕터 목록 출력
  • 요약(Summary): 전체 동영상에 대한 간결한 5~10문장 개요
  • 챕터 요약(Chapter summaries): 각 챕터별 짧은 단락 요약이 포함된 챕터
  • 스레드(Thread): 트위터/X 스레드 형식 — 번호가 매겨진 게시물, 각 최대 280자
  • 블로그 게시물(Blog post): 제목, 섹션, 주요 내용이 포함된 전체 글
  • 인용문(Quotes): 타임스탬프가 포함된 주요 인용문

예시 — 챕터 출력

00:00 도입 — 진행자가 문제 설명으로 시작
03:45 배경 — 선행 연구 및 기존 솔루션의 한계
12:20 핵심 방법 — 제안된 접근 방식 상세 설명
24:10 결과 — 벤치마크 비교 및 주요 시사점
31:55 Q&A — 확장성 및 다음 단계에 대한 청중 질문

작업 흐름

  1. 자막 가져오기: uv run python3을 사용하여 도우미 스크립트를 --text-only --timestamps 옵션으로 실행합니다.
  2. 유효성 검사: 출력이 비어 있지 않고 예상 언어인지 확인합니다. 비어 있으면 --language 없이 다시 시도하여 사용 가능한 자막을 가져옵니다. 그래도 비어 있으면 사용자에게 해당 동영상에 자막이 비활성화되었을 가능성이 있다고 알립니다.
  3. 필요시 청크 분할: 자막이 약 50,000자를 초과하면 중첩된 청크로 분할(약 40,000자, 2,000자 중첩)하여 각 청크를 요약한 후 병합합니다.
  4. 변환: 요청된 출력 형식으로 변환합니다. 사용자가 형식을 지정하지 않은 경우 기본적으로 요약문을 출력합니다.
  5. 최종 검증: 변환된 출력을 다시 읽어 일관성, 올바른 타임스탬프, 완전성을 확인한 후 제시합니다.

오류 처리

  • 자막 비활성화: 사용자에게 알리고, 동영상 페이지에서 자막을 사용할 수 있는지 확인하도록 안내합니다.
  • 비공개/사용 불가 동영상: 오류를 전달하고 사용자에게 URL을 확인하도록 요청합니다.
  • 일치하는 언어 없음: --language 없이 다시 시도하여 사용 가능한 자막을 가져온 후, 실제 언어를 사용자에게 알립니다.
  • 의존성 누락: uv pip install youtube-transcript-api를 실행하고 다시 시도합니다.

Individual skills in this repo

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

delorenj/skills

Plan and generate terminal ASCII animations/screensaver-style output (FPS, refresh rules, loop policy, low-flicker guidance), with a static poster frame and an optional local demo script.

delorenj/skills

ASCII video: convert video/audio to colored ASCII MP4/GIF.

delorenj/skills

Plan, build and quality-check a premium short commercial for a real business (roofing, property, ecommerce, B2B software) using AI-generated footage, code-built motion (HTML/GSAP), selective Three.js and an independent-critic "Gauntlet" loop. Use when asked to make a launch-style / SaaS-style video, business ad, explainer, sample reel or pitch video, or to review and improve one. Encodes motion principles distilled from 28 professional launch films, a quality bar, audio rules and a business-offer playbook.

delorenj/skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

delorenj/skills

Generate professional voiceovers using ElevenLabs AI. Use when the user needs to create voiceovers for videos, audio narration, or text-to-speech content. Supports multiple voices with character presets (narrator, salesperson, expert) for natural delivery. Includes single scene regeneration for fine-tuning.

delorenj/skills

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

delorenj/skills

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

delorenj/skills

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

delorenj/skills

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For dev-loop CLI commands (init, lint, inspect, preview, render) see the hyperframes-cli skill; for asset preprocessing commands (tts, transcribe, remove-background) see the hyperframes-media skill.

delorenj/skills

Manim CE animations: 3Blue1Brown math/algo videos.

delorenj/skills

Join a Google Meet or Zoom call as a video meeting agent via PikaStreaming. Trigger: user drops a Google Meet or Zoom link, or asks to join a meeting.

delorenj/skills

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames (e.g. "port my Remotion project to HyperFrames"). Do NOT use when (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video); (b) Remotion is mentioned in passing; (c) Remotion code is shared as reference, not for translation; (d) the user wants "the same video as my Remotion one" without explicitly asking to migrate the source — treat as a fresh HyperFrames build. When in doubt, default to the `hyperframes` skill. Detects unsupported patterns (useState, useEffect side effects, async calculateMetadata, third-party React component libraries, `@remotion/lambda`) and recommends the runtime interop escape hatch instead of a lossy translation.

delorenj/skills

Generate speech using the self-hosted voxxy (vox) TTS service at https://vox.delo.sh. Use when the user asks to speak, say, narrate, synthesize speech, clone a voice, create a voice, add or register a voice, pipe TTS, or control voice qualities by description (e.g. "a young woman with a cheerful voice"). Handles HTTP API usage, voice profile management, description-based voice design, cloning, MCP registration, and integration patterns for new platforms.

delorenj/skills

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

관련 스킬