Communitygithub.com

Captions From Transcript (자막 생성)

비디오 오디오에서 정확하고 적절한 타이밍의 자막 트랙(SRT 또는 WebVTT)을 생성합니다. 음성 해설 스크립트를 전사하거나 정렬하고, 음성에 맞춰 큐를 동기화하며, 가독성과 읽기 속도 규칙을 적용하여 자막이 읽기 쉽고 동기화되도록 합니다.

Captions From Transcript (자막 생성)란 무엇인가요?

이 스킬은 비디오의 오디오를 기반으로 정확하고 읽기 쉬운 자막 파일(SRT 또는 WebVTT)을 생성하는 AI 어시스턴트 기능입니다. 주요 사용 사례는 "자막 생성", "오디오에서 자막 만들기", "전사 및 자막 생성", "SRT 또는 VTT 내보내기", "자막 동기화 문제 해결", "자막이 너무 빨리 지나감"과 같은 요청입니다. 이 스킬은 기존 내레이션 스크립트를 활용하거나 Whisper 등의 ASR(자동 음성 인식)을 통해 오디오를 전사한 후, 비디오와 대조하여 기술 용어, 코드, UI 레이블 등을 정확하게 수정합니다. 결과물은 음성 큐에 정확히 정렬되며, 1~2줄, 줄당 32~42자, 초당 17자 이하의 읽기 속도 등 가독성 규칙을 준수합니다. 이 스킬은 자막의 스타일링, 위치 지정, 프레임에 굽기(burn-in) 작업은 수행하지 않으며, 해당 작업은 별도의 social-video-formatter 스킬에 위임합니다. 최종 출력은 SRT(범용) 또는 WebVTT(HTML5 웹 플레이어) 형식으로 제공되며, 유효하고 파싱 가능한 형식을 보장합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SkillMedev/skills/tree/HEAD/skills/captions-from-transcript

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

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

문서

스크립트 기반 자막 생성

자막은 선택적인 장식이 아닙니다. 접근성이며, 음소거 시청자를 붙잡고, 튜토리얼에서는 정확한 UI 용어를 강화합니다. 이 스킬은 깔끔하고 정확한 타이밍의 자막 파일을 생성합니다. 스타일링 및 굽기(burn-in)는 이후 단계에서 처리됩니다.

가장 정확한 텍스트부터 시작

정확성은 시작점에 따라 달라집니다:

  • 내레이션 스크립트가 있다면 이를 기준으로 사용합니다. 기술 용어와 UI 레이블이 이미 정확합니다. 처음부터 다시 전사하는 대신 오디오에 맞춰 정렬하세요.
  • 그렇지 않으면 오디오를 전사(Whisper, 플랫폼의 자동 자막, 또는 기타 ASR)하고 비디오와 대조하여 수정합니다. ASR은 제품명, 코드, 약어를 자주 잘못 인식합니다. 화면에 정확히 표시된 대로 모두 수정하세요.

원시 ASR 출력을 그대로 사용하지 마세요. 오류는 항상 가장 중요한 단어에서 발생합니다.

음성에 맞춰 큐 타이밍 설정

  • 각 큐는 해당 줄이 말해질 때 나타나고 끝날 때 사라집니다. 임의의 간격이 아닌 음성에 맞춰 정렬하세요.
  • 최소 약 1초(짧은 큐라도), 최대 약 7초 화면에 표시됩니다. 더 긴 것은 분할하세요.
  • 문장 중간에 간격을 두지 마세요. 문장 사이의 작은 간격은 괜찮으며 가독성을 높입니다.

줄 및 읽기 규칙

  • 큐당 1-2줄, 절대 3줄을 넘지 않습니다.
  • 줄당 약 32-42자. 이를 초과하면 프레임을 어지럽히고 안전 영역을 벗어납니다.
  • 읽기 속도 ≤ 초당 약 17자(약 160-180 wpm). 큐가 이를 초과하면 단어가 빠르게 지나가므로 큐를 분할하거나 지속 시간을 늘리세요.
  • 절(clause) 경계에서 줄을 나누고, 구(phrase) 중간에 나누지 마세요. "설정 페이지로"를 함께 유지하고, "를"을 한 줄에 홀로 두지 마세요.

형식 선택

  • SRT - 범용, 인덱스 + HH:MM:SS,mmm --> HH:MM:SS,mmm + 텍스트. 대부분의 플랫폼 및 편집기에 업로드할 때 사용합니다.
  • WebVTT (.vtt) - WEBVTT 헤더, HH:MM:SS.mmm 타임스탬프, 큐 위치/스타일 지정 지원. HTML5 <track> 및 웹 플레이어에 사용합니다.

유효하고 파싱 가능한 출력을 생성하세요. 올바른 타임스탬프 구두점(SRT는 밀리초 앞에 쉼표, VTT는 마침표 사용), 큐 사이 빈 줄, 후행 공백 없음.

깔끔한 vs 축어적

튜토리얼의 경우 깔끔한 자막: 필러("음", "어", 잘못된 시작)를 제거하고 의미는 그대로 유지합니다. 기술 용어, 코드, UI 레이블은 정확히 보존합니다. 사용자가 명시적으로 필요로 하는 경우(법률, 연구, 정확한 인용 맥락)에만 엄격한 축어적 방식을 사용하세요.

동기화 품질 검사(QA)

실제 비디오와 시작, 중간, 끝 지점에서 대조 점검하세요. 드리프트가 누적됩니다. 큐가 해당 줄에 도착하고 다음 큐가 시작되기 전에 사라지는지 확인하세요. 잘못된 장면에 남아 있는 자막을 수정하세요.

인계

완성된 .srt / .vtt는 social-video-formatter에 전달되어 굽기(burn-in) 및 플랫폼 스타일링을 수행하거나, 웹 플레이어의 <track> 요소에 직접 제공됩니다. 색상, 글꼴, 위치, 애니메이션은 해당 단계에 맡기세요. 이 스킬은 정확하고 적절한 타이밍의 텍스트만 출력하며 그 외에는 아무것도 하지 않습니다.

하지 말아야 할 것

  • 자막을 프레임에 스타일링, 색상 지정, 위치 지정, 굽기하지 마세요. 이는 social-video-formatter의 작업입니다.
  • 단어를 단어별로 애니메이션하지 마세요. 이는 kinetic-typography의 작업입니다.
  • 수정되지 않은 ASR을 그대로 사용하지 마세요. 오류는 정확히 중요한 용어에 집중됩니다.
  • 큐 분할을 피하기 위해 3줄을 사용하거나 읽기 속도 예산을 초과하지 마세요. 큐를 분할하세요.

Individual skills in this repo

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

SkillMedev/skills

Designs REST API surfaces - resource naming, HTTP method and status-code semantics, error shapes, pagination, and filtering - and delivers an endpoint spec a consumer can build against without asking questions. Use when someone asks "how should I name this endpoint", "what status code should this return", "should this be PUT or PATCH", "how do I paginate this list", or is reviewing an API before it ships to external consumers. Do NOT use for planning breaking-change rollouts and deprecation windows - use api-versioning-strategist instead; for GraphQL type and resolver design - use graphql-schema instead; for generating client SDKs from an existing spec - use api-client-generator instead; for designing inbound webhook endpoints - use webhook-receiver-hardener instead.

SkillMedev/skills

Turns data and charts into a decision-driving narrative structured as headline finding, trend, implication, and recommended action - with finding-led chart titles, context for every number, annotation guidance, and honest flags on any conclusion the data cannot support. Use when someone says "turn these numbers into a story", "what's the takeaway from this data", "help me present these results to leadership", or has charts but no narrative. Do NOT use for compressing a long document into a one-pager - use executive-summary instead - or for running the analysis that produces the findings - use eda-playbook instead.

SkillMedev/skills

Use when a task needs live or historical money data - "convert USD to EUR", "current/past exchange rate", "FX rate on this date / over this range", or "current price of Bitcoin/Ethereum, market cap, 24h change". Frankfurter (ECB reference rates, no key) is the FX default; CoinGecko's free keyless tier covers crypto. Do NOT use for stock quotes or equities - no keyless stock API survives verification, say so instead of guessing; do NOT use for country economic indicators like GDP or inflation series - use government-open-data instead; if the request is a vague "I need live data", route through public-data-api-picker.

SkillMedev/skills

Builds a driver-based FP&A operating model linking business inputs to P&L, balance sheet, and cash flow outputs. Use when building an annual plan, preparing investor materials, running scenario analysis, or stress-testing the business.

SkillMedev/skills

Use when a task needs live geographic lookups - "geocode this address", "what's at these coordinates" (reverse geocoding), "lat/lon for this city", "which country/state is this ZIP or postal code in", or "country facts: capital, currency, population, flag". Nominatim (OpenStreetMap) is the geocoding default; Zippopotam for postal codes; APICountries for country facts. All keyless. Do NOT use for weather at a location - use weather-climate instead; do NOT use for country-level statistics over time (GDP, population trends) - use government-open-data instead; if the request is a vague "I need live data", route through public-data-api-picker.

SkillMedev/skills

Runs the full Getting Things Done loop - capture, clarify, organize, reflect, engage - building a trusted system of context lists, a projects list with defined next actions, and a weekly review habit. Use when someone says "I'm overwhelmed and things are slipping through the cracks", "set up GTD for me", "help me do a brain dump and organize it", or "my to-do list is a mess". Do NOT use for just running the weekly review ritual itself - use weekly-review instead - or for clearing an email backlog - use inbox-zero.

SkillMedev/skills

Processes any email backlog to zero using the 4Ds - Delete, Delegate, Defer, Do - with a mass-archive strategy for the obvious, a touch-each-email-once discipline, and a keep-it-clear system of batched processing windows, ruthless unsubscribing, filters, and a minimal folder setup. Use when someone says "I have 5,000 unread emails", "help me get to inbox zero", "email is eating my whole day", or treats their inbox as a to-do list. Do NOT use for drafting the reply emails themselves or prioritization rules for an ongoing support queue - use email-triage instead - or for protecting focus time around the email windows - use deep-work-planner instead.

SkillMedev/skills

Write landing-page copy section by section - hero, social proof, features-as-benefits, objections, CTA - leading with one promise and proving it down the page. Use when someone asks "write my landing page", "improve my hero headline", "what should the homepage say", "turn these features into benefits", or is shipping a new page for a launch or campaign. Do NOT use for testing and optimizing an existing page's conversion rate - use landing-page-cro instead; for the one-line claim itself use positioning-statement; for the full message ladder use messaging-hierarchy.

SkillMedev/skills

Improves an existing landing page's conversion rate through evidence-first CRO - audit heatmaps and recordings, write structured hypotheses, prioritize with ICE scoring, and run one-variable tests to statistical significance. Use when someone asks "why isn't my landing page converting", "audit this page before we scale spend", "which A/B test should we run first", or after a CVR drop or ahead of a paid-traffic push. Do NOT use for writing a new landing page from scratch - use landing-page-copy instead. Do NOT use for auditing the ad accounts sending the traffic - use paid-acquisition-audit instead. Do NOT use for reading the results of a finished experiment - use ab-test-analyzer instead.

SkillMedev/skills

Runs structured coaching sessions using values clarification and the GROW model, ending every session with one committed action, a deadline, and an if-then plan for the likely obstacle. Use when someone says "I feel stuck in my life", "help me figure out what I want", "hold me accountable to my goals", or "coach me through this decision". Do NOT use for building a stress toolkit - use stress-management instead - or a journaling practice - use journal-framework; for a standing goal-tracking system, use goals-accountability. Coaching, not therapy: signs of clinical distress route to a licensed professional.

SkillMedev/skills

Adapts English content for a target language and region - swapping idioms, setting the right formality register, replacing cultural references, converting dates, units, and currency - and delivers the localized text with a notes column explaining each adaptation and flagging what needs a native reviewer. Use when someone asks "localize this copy for the Japanese market", "adapt our marketing copy for the Mexican market", "make this translation sound native instead of literal", or a literal translation reads foreign, stiff, or risky. Do NOT use for auditing in-product UI text quality - use ux-writing-audit instead.

SkillMedev/skills

Turns a natural-language video brief into a complete, ready-to-preview Remotion composition - extracts duration, scenes, brand colors, aspect ratio, and real copy; plans the frame budget; and writes data-driven React/TypeScript using useCurrentFrame, interpolate, spring, AbsoluteFill, and Sequence, registered in Root.tsx. Use when someone says "build a 20-second product demo video", "animate a feature walkthrough", "write the Remotion code for this marketing clip", or wants a scene-by-scene composition they can scrub in Studio. Do NOT use for rendering, iterating, or batching the finished MP4 - use remotion-render instead - or for installing and scaffolding the project - use remotion-setup instead.

SkillMedev/skills

Scaffolds a new Remotion video project wired for Claude Code Agent Skills - Node check, create-video scaffold, skills install, folder conventions, Google Fonts, and a smoke-test render. Use whenever someone wants to start making videos with Remotion and Claude, even just "make product videos with Claude.

SkillMedev/skills

Classifies incident severity (SEV1-4) using impact, scope, and urgency signals and decides who to page. Use when an alert fires or a report comes in and a severity call must be made quickly.

SkillMedev/skills

Use the Skill Me catalog from inside any conversation - discover, install, and manage Claude skills through the Skill Me MCP, and load installed skills automatically each session.

SkillMedev/skills

Write one platform-native caption from a topic and brand voice, with a front-loaded hook, native length, and a single earned CTA. Use when the user gives a topic (and optionally brand voice or a described image/video) and asks for an Instagram, LinkedIn, X/Twitter, or TikTok caption. Do NOT use when the user wants a dedicated standalone LinkedIn post - use linkedin-post-writer instead; or a multi-post X thread - use tweet-thread-builder instead; or to adapt one existing piece of content into versions for several channels - use cross-platform-reformatter instead.

SkillMedev/skills

Reframe and export a finished video for social platforms - 9:16 ↔ 16:9 cropping, burned-in captions, a platform-native first frame, loop design, and per-platform specs (aspect, length, safe areas) for TikTok, Reels, Shorts, X, and LinkedIn. Use when someone says "make this vertical", "crop to 9:16", "format for TikTok/Reels/Shorts", "add captions/subtitles", "why is my video cut off on mobile", "resize for Instagram", or "export for social". Do NOT use when the question is about the storyboard or shot order before any video exists (use video-storyboard); the animation craft of how elements move (use motion-design-principles); animated word-by-word caption styling (use kinetic-typography); palette, contrast, or lighting (use motion-color-and-light); directing the product-demo content and screen choreography (use product-demo-director); or scoring, beat-syncing, or audio (use sound-and-music-sync) - this is the craft layer that decides WHAT to format for the feed, then hands a concrete spec to remotion-compo...

SkillMedev/skills

Writes and tunes PySpark jobs - join strategy and broadcast size limits, shuffle-partition sizing, skew diagnosis and salting, UDF avoidance, caching, and output file layout - with concrete size and skew thresholds. Use when someone asks "why is my Spark job slow", "should I broadcast this join", "one task takes forever while the rest finish", "my job OOMs during a join", or is writing a new PySpark ETL job. Do NOT use for Kafka topic, consumer-group, or streaming-pipeline design - use kafka-pipelines instead; do NOT use for single-machine dataframe work that fits in memory - use pandas-expert instead.

SkillMedev/skills

Builds clean, performant, accessible SwiftUI views with correct state ownership, scoped invalidation, and smooth list scrolling, and reviews existing SwiftUI code against a concrete frame-time and re-render budget. Use when someone asks "why does my SwiftUI list stutter", "should this be @State or @Observable", "my whole screen re-renders when one row changes", "how do I animate this transition", or wants a SwiftUI view built or refactored. Do NOT use for cross-platform React Native apps - use react-native-pro instead; do NOT use for Flutter widget trees - use flutter-widget-architect instead; do NOT use for Android Compose UIs - use jetpack-compose-builder instead.

관련 스킬