Communitygithub.com

AlemTuzlak/skills

ユーザーが動画や音声ファイルを文字起こしし、単語レベルのタイムスタンプを取得したいときに使用します。このスキルにバンドルされた自己完結型のローカルWhisper(whisper.cpp)Dockerサービスを起動し、transcript.txt、transcript.srt、単語レベルのtranscript.words.jsonを返します。また、/produce-videoの構成要素としても使用されます。「この動画を文字起こしして」「文字起こしを取得」「transcribe-video」でトリガーされます。

skills とは?

このスキルは、whisper.cppをベースにしたDockerサービスをローカルで起動し、動画や音声ファイルから高精度な文字起こしを実行します。外部のクラウドAPIやプロジェクトに依存せず、すべての処理がスキル内で完結するため、プライバシーを重視するユーザーやオフライン環境での利用に適しています。主な特徴は、単語レベルのタイムスタンプを生成できる点で、これにより字幕やオーバーレイと正確に同期したキャプションを作成できます。出力はプレーンテキスト(transcript.txt)、SRT形式の字幕(transcript.srt)、単語ごとのタイムスタンプJSON(transcript.words.json)の3種類で、プログラムによる呼び出しにも対応しています。スキルは自動的にDockerイメージのビルドとコンテナの管理を行い、ユーザーはDockerやffmpegがインストールされていれば、簡単なコマンドで文字起こしを実行できます。また、/produce-videoなどの上位スキルの構成要素としても利用できるよう設計されています。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AlemTuzlak/skills/tree/HEAD/skills/transcribe-video

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Transcribe Video(動画文字起こし)

バンドルされたwhisper.cppサービスを使用して、動画/音声ファイルをローカルで文字起こしします。外部プロジェクトやクラウドAPIは不要です。同期オーバーレイ/キャプションに必要な単語レベルのタイムスタンプを返します。

使用するタイミング

  • 「このクリップ/動画/音声を文字起こしして」「タイムスタンプ付きの文字起こしを取得」
  • /produce-videoのサブステップとして

実行方法

すべてはバンドルされたランナーによって処理されます。ユーザーにDockerの管理を依頼しないでください:

node scripts/transcribe.mjs <動画または音声ファイルへのパス> [--out <ディレクトリ>] [--port 9111] [--language en] [--no-word-ts] [--task transcribe|translate]
node scripts/transcribe.mjs --stop      # ウォームコンテナを停止

ランナーは以下の処理を行います:

  1. Dockerデーモンが利用可能かを確認(不可の場合はガイダンスとともにエラーメッセージを表示)。
  2. assets/whisper-service/ から transcribe-video-whisper イメージが存在しない場合にビルド(初回ビルドは遅い:whisper.cppをコンパイルし、ggml-base.en.bin モデルを組み込みます)。
  3. transcribe-video-whisper コンテナを起動(ホストポート9111 → コンテナ9001);すでに実行中の場合は再利用、停止中の場合は docker start で起動。
  4. GET /healthz がOKを返すのを待機。
  5. ローカルの ffmpeg を使用して入力から16kHzモノラルWAVを抽出し(whisper.cppはWAVのみデコード可能)、word_ts=true を付けて /transcribe にPOST。
  6. transcript.txt、transcript.srt、transcript.words.json を --out(デフォルト:入力ファイルのディレクトリ)に書き込み、JSON結果行をstdoutに出力。

出力

  • transcript.txt — プレーンテキスト。
  • transcript.srt — 字幕テキスト。
  • transcript.words.json — [{ "word", "start", "end" }]、秒単位、時系列順。オーバーレイ/キャプションの同期ソース。

stdout結果行(/produce-video などのプログラム呼び出し用):

{ "ok": true, "outDir": "...", "wordCount": 38, "segmentCount": 2, "files": { "txt": "transcript.txt", "srt": "transcript.srt", "words": "transcript.words.json" } }

要件

  • Dockerが必要です — Whisperサービスはコンテナ内で実行されるため、Docker Desktopがインストールされ、実行されている必要があります。ランナーは最初にこれを確認し、Dockerがない場合やデーモンが停止している場合は、インストール/起動のガイダンスとともにエラーメッセージを表示します。Dockerなしのフォールバックはありません。
  • ffmpegが必要です(Whisper用に16kHzモノラルWAVを抽出するために使用) — ランナーは事前にこれを確認し、PATHにない場合はエラーメッセージを表示します。
  • Node.js 22以上。

注意事項

  • コンテナはウォーム再利用のために起動したままにされます(--restart unless-stopped)。--stop で停止します。
  • 単語タイムスタンプが要求されたが返ってこない場合、ランナーはエラーメッセージを表示します(オーバーレイ同期がこれに依存するため)。
  • Dockerのライフサイクル、APIの形状、ベンダリングの出典については references/ を参照してください。

Individual skills in this repo

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

AlemTuzlak/skills

Use when the user wants to write a blog post about a feature, product change, PR, git diff, or any technical topic - accepts marketing briefs, PRs, git refs, codebase paths, or freeform descriptions as input

AlemTuzlak/skills

Use when the user wants to generate a changelog, release notes, or document what changed between versions, tags, or PRs

AlemTuzlak/skills

Use when writing, editing, or organizing documentation, when planning what docs a feature needs, and whenever planning or implementing a new feature or change in a repo (docs ship with the code). Also use when tempted to write docs without showing the discovered readers to the user, without asking for tone, or without loading simple-english and i-have-adhd. Triggers on "write docs for X", "document this feature", "add a guide", "update the docs", "reorganize the docs", "plan feature X", "implement X", or /docs.

AlemTuzlak/skills

Use when a bug is in play: a test fails, CI is red, an API returns the wrong result, a stack trace appears, or the user says it is broken or fix this. Don't use for a new feature with no failure, for types-only work, or for docs.

AlemTuzlak/skills

Use when the user invokes /i-have-adhd, says they have ADHD, or asks for ADHD-friendly output. Also used as a required writing filter by the docs skill. Don't use for marketing copy or after the user says "stop adhd mode" or "normal mode".

AlemTuzlak/skills

Use when a settled change must be turned into an ordered stack of small blocks before anyone implements. Don't use for unsettled intent, typos, comments, formatting, docs-only work, or writing the implementation itself.

AlemTuzlak/skills

Use when the user wants to write a product update email, feature announcement newsletter, or digest email for users or subscribers

AlemTuzlak/skills

Use when the user wants to turn a raw talking-head / screen-share recording into a finished, edited, annotated video plus a full content package. Removes silences, flags mistakes for the user to cut, transcribes, adds transcript-synced overlays (code, on-screen code highlights, word highlights, lists, comparisons, diagrams, section labels, punch-in zooms), renders with original audio, then generates blog/socials/YouTube content. Triggers on "produce a video", "edit my video", "annotate my recording", "/produce-video".

AlemTuzlak/skills

Use when the user runs /prove-it or says prove it, prove the changes, show me in the browser, or asks to prove a UI or API change. Don't use only because the agent is about to say done, for types-only work, or for docs with no behavior to prove.

AlemTuzlak/skills

Use when the user wants to write, draft, or author an RFC (Request for Comments) / technical design doc for a feature, change, or architectural decision. Interactively interviews the user, grounds the proposal in the actual codebase, presents 2-3 concrete API/code-snippet approaches to choose from, then writes a review-ready RFC. Triggers on "write an RFC", "draft an RFC", "RFC for X", "design doc for X", or /rfc.

AlemTuzlak/skills

Use when the user wants to deeply learn a new topic from scratch. Runs a pre-interview (current knowledge, end-goal proficiency, depth, practice load, background, scope), researches online (articles, niche-influencer blogs, canonical docs, subtopic landscape), then produces a structured markdown course with mandatory visual diagrams, evidence-based learning-science features (retrieval practice, spaced callbacks, worked-example fading, concept ledger, jargon gate, analogy hygiene), and a self-contained interactive HTML mini-course. Triggers on /teach-me, "teach me about X", "I want to learn X", "deep dive on X", "create a course on X", "study X with me".

AlemTuzlak/skills

Use when the change intent is already settled and the agent must map what a behavior change touches before an implementation plan or any code. Use for new features, bug fixes, and refactors that move a boundary. Don't use for typos, comments, formatting, lockfile-only diffs, docs with no code, or while the user is still deciding what they want.

AlemTuzlak/skills

Use when the user wants to write a video script for a product demo, feature walkthrough, launch video, or social media video about a feature or product change

AlemTuzlak/skills

Use when the user wants YouTube metadata for a video — a click-worthy title, an SEO/above-the-fold description, tags, and timestamped chapters. Accepts a transcript (ideally timestamped SRT), a topic, a PR, or a freeform description. Used standalone and by /produce-video. Triggers on "youtube title", "youtube description", "youtube chapters", "youtube tags", "youtube metadata", "youtube-copy".

関連スキル