Communitygithub.com

delorenj/skills — YouTubeコンテンツツール

YouTubeの動画から文字起こしを取得し、要約、スレッド、ブログ記事などに変換します。

skills — YouTubeコンテンツツール とは?

このスキルは、YouTube動画のURLを受け取り、文字起こし(トランスクリプト)を取得して、さまざまなフォーマットに変換するツールです。ユーザーが動画の要約、文字起こしの取得、ブログ記事やTwitterスレッドへの整形を依頼した際に活用できます。対応プラットフォームはClaude CodeやCursorなど、任意のAIエージェントで動作し、`youtube-transcript-api`というPythonライブラリを使用して文字起こしデータを取得します。取得後は、文字起こしをタイムスタンプ付きのチャプター、5〜10文の要約、チャプターごとの短い要約、280文字以内のツイート形式スレッド、見出し付きのブログ記事、重要な引用リストなどに変換できます。大規模な文字起こし(50K文字以上)は自動的にチャンク分割して処理し、エラー時には代替言語での再試行や字幕が無効の場合のユーザーへの通知を行います。

対応✓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)、ショート動画、埋め込み、ライブ動画のリンク、または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

出力フォーマット

文字起こしを取得した後、ユーザーの要求に応じて以下の形式にフォーマットします。

  • チャプター: トピックの変化ごとにグループ化し、タイムスタンプ付きのチャプターリストを出力
  • 要約: 動画全体の簡潔な5〜10文の概要
  • チャプター要約: 各チャプターに短い段落の要約を付けたもの
  • スレッド: Twitter/Xスレッド形式 — 各投稿が280文字以内で番号付き
  • ブログ記事: タイトル、セクション、重要なポイントを含む完全な記事
  • 引用: タイムスタンプ付きの注目すべき引用

例 — チャプター出力

00:00 導入 — ホストが問題定義から開始
03:45 背景 — 先行研究と既存の解決策が不十分な理由
12:20 コア手法 — 提案手法の詳細な解説
24:10 結果 — ベンチマーク比較と主要な結果
31:55 Q&A — スケーラビリティと次のステップに関する質疑応答

ワークフロー

  1. 取得: ヘルパースクリプトをuv run python3で実行し、--text-only --timestampsオプションを指定して文字起こしを取得します。
  2. 検証: 出力が空でなく、期待する言語であることを確認します。空の場合は--languageオプションなしで再試行し、利用可能な文字起こしを取得します。それでも空の場合は、ユーザーに動画で字幕が無効になっている可能性があることを伝えます。
  3. 必要に応じてチャンク分割: 文字起こしが約50K文字を超える場合は、重複するチャンク(約40K文字、2K文字重複)に分割し、各チャンクを要約してからマージします。
  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.

関連スキル