Communitygithub.com

AlemTuzlak/skills

當使用者想要將影片或音訊檔案轉錄為文字,且需要逐字時間戳時使用。此技能會啟動一個自包含的本地 Whisper (whisper.cpp) Docker 服務,並回傳 transcript.txt、transcript.srt 以及逐字時間戳的 transcript.words.json。也可作為 /produce-video 的建構模組。觸發詞包括「轉錄這段影片」、「取得逐字稿」、「transcribe-video」。

skills 是什麼?

此 AI 技能提供了一個完全本地化的語音轉文字解決方案,內建於一個自包含的 Docker 服務中。它基於 whisper.cpp,無需依賴任何外部雲端 API 或專案,確保資料安全與低延遲。技能會自動管理 Docker 容器的生命週期,包括映像檔的建置、容器的啟動與停止,以及暖啟動重複使用,大幅簡化使用者操作。輸出的文字結果包含純文字、SRT 字幕以及精確到逐字的 JSON 時間戳檔案,非常適合需要同步疊加字幕或動態標註的場景(例如影片製作)。此技能在 Claude Code、Coder 等 AI 代理平台中作為獨立工具或影片製作流程的子步驟運作,關鍵依賴為 Docker 與 ffmpeg。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AlemTuzlak/skills/tree/HEAD/skills/transcribe-video

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

轉錄影片

使用內建的 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. 若 transcribe-video-whisper 映像檔不存在,則從 assets/whisper-service/ 建置該映像檔(首次建置較慢:會編譯 whisper.cpp 並內嵌 ggml-base.en.bin 模型)。
  3. 啟動 transcribe-video-whisper 容器(主機連接埠 9111 → 容器 9001);若容器已在執行則重複使用,若已停止則 docker start。
  4. 等待 GET /healthz 回報正常。
  5. 使用本機 ffmpeg 從輸入檔案中提取 16 kHz 單聲道 WAV(whisper.cpp 僅解碼 WAV),然後透過 POST 將其傳送至 /transcribe,並帶有 word_ts=true。
  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 提取 16 kHz 單聲道 WAV)— 執行器會預先檢查,若未在 PATH 中則會顯示明確的錯誤訊息。
  • Node ≥ 22。

備註

  • 容器會保持執行狀態 (--restart unless-stopped) 以便暖啟動重複使用;使用 --stop 停止。
  • 若要求逐字時間戳但未回傳任何資料,執行器會顯示明確的錯誤訊息(疊加字幕的同步依賴於此)。
  • 請參閱 references/ 了解 Docker 生命週期、API 格式以及套件來源。

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".

相關技能