Communitygithub.com

AlemTuzlak/skills

사용자가 비디오나 오디오 파일을 단어 수준 타임스탬프와 함께 텍스트로 변환하려 할 때 사용합니다. 이 스킬에 번들된 로컬 Whisper (whisper.cpp) Docker 서비스를 실행하여 transcript.txt, transcript.srt, 단어 수준 transcript.words.json을 반환합니다. 또한 /produce-video의 구성 요소로도 사용됩니다. "이 비디오를 자막으로 변환해줘", "자막 추출", "transcribe-video" 등의 트리거에 반응합니다.

skills란 무엇인가요?

이 스킬은 로컬 환경에서 whisper.cpp 기반 Docker 서비스를 활용하여 비디오/오디오 파일을 텍스트로 변환(전사)하는 자체 포함형 솔루션입니다. 외부 클라우드 API나 프로젝트에 의존하지 않으며, Docker와 ffmpeg만 설치되어 있으면 모든 처리가 로컬에서 이루어집니다. 특히 단어 수준 타임스탬프(word-level timestamps)를 제공하여 자막 동기화, 오버레이 제작, 정밀한 캡션 생성에 필수적입니다. 이 스킬은 Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, Node.js 스크립트 한 줄로 Docker 이미지 빌드, 컨테이너 실행, WAV 변환, 전사 요청 및 결과 파일 생성을 자동화합니다. 결과물로 일반 텍스트, SRT 자막, 그리고 단어별 타임스탬프 JSON 파일을 제공하므로, 프로그래매틱 호출(예: /produce-video)에도 안성맞춤입니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AlemTuzlak/skills/tree/HEAD/skills/transcribe-video

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

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

문서

비디오 자막 변환

번들된 whisper.cpp 서비스를 사용하여 로컬에서 비디오/오디오 파일을 텍스트로 변환합니다. 외부 프로젝트나 클라우드 API가 필요 없습니다. 단어 수준 타임스탬프를 반환합니다 (동기화된 오버레이/캡션에 필요).

사용 시점

  • "이 클립/비디오/오디오를 자막으로 변환해줘", "타임스탬프가 포함된 자막을 가져와줘".
  • /produce-video의 하위 단계로 사용.

실행 방법

모든 작업은 번들된 실행기(runner)에 의해 처리되며, 사용자에게 Docker를 직접 관리하도록 요청하지 마세요:

node scripts/transcribe.mjs <비디오-또는-오디오-파일-경로> [--out <디렉토리>] [--port 9111] [--language ko] [--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가 정상 응답을 반환할 때까지 기다립니다.
  5. 로컬 ffmpeg를 사용하여 입력 파일에서 16kHz 모노 WAV를 추출한 후 (whisper.cpp는 WAV만 디코딩), word_ts=true와 함께 /transcribe로 POST 요청을 보냅니다.
  6. transcript.txt, transcript.srt, transcript.words.json을 --out 디렉토리에 기록하고 (기본값: 입력 파일의 디렉토리), 표준 출력에 JSON 결과 줄을 출력합니다.

출력 파일

  • transcript.txt — 일반 텍스트.
  • transcript.srt — 자막 텍스트.
  • transcript.words.json — [{ "word", "start", "end" }] 형식, 초 단위, 시간순 정렬. 오버레이/캡션 동기화의 소스입니다.

표준 출력 결과 줄 (프로그래매틱 호출자, 예: /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 추출에 사용) — 실행기는 ffmpeg를 먼저 확인하고 PATH에 없으면 오류를 출력합니다.
  • Node ≥ 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".

관련 스킬