Communitygithub.com

スクリプトからキャプション生成

動画の音声から正確で適切なタイミングのキャプションファイル(SRT または WebVTT)を生成します。ナレーションスクリプトがあればそれに合わせて、なければ音声認識で文字起こしし、読みやすさと同期を保つために行長や読み速度のルールを適用します。

スクリプトからキャプション生成 とは?

このスキルは、動画の音声に基づいた高品質なキャプションファイル(SRT または WebVTT)を生成するために設計されています。まず、ナレーションスクリプトが存在する場合はそれを正解データとして活用し、音声に合わせてタイミングを調整します。スクリプトがない場合、Whisper などの ASR で文字起こしを行い、技術用語や UI ラベルを映像に合わせて正確に修正します。キャプションは 1~2 行、1 行あたり約 32~42 文字、読み速度は 17 文字/秒以下に制限することで、映像内の安全領域に収まり、視聴者が容易に読めるようにします。タイミングは発話に合わせ、最小 1 秒、最大 7 秒の範囲で調整し、不自然な間や重なりを排除します。出力形式は SRT(汎用)と WebVTT(HTML5 対応)の両方をサポートし、正確なタイムスタンプと書式を守ります。このスキルはキャプションのスタイル付けや焼き込み(burn-in)は行わず、それらは downstream のスキル(social-video-formatter)に任せます。使用例として「字幕を生成」「音声から字幕作成」「SRT 出力」「字幕がずれている」「字幕が速すぎる」などのリクエストに対応します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SkillMedev/skills/tree/HEAD/skills/captions-from-transcript

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

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

ドキュメント

スクリプトからキャプション生成 は何をしますか?

キャプションは単なる飾りではありません。アクセシビリティであり、ミュートで視聴するユーザーを引き付け、チュートリアルでは画面上の正確な UI 用語を補強します。このスキルはクリーンで正確にタイミング調整されたキャプションファイルを生成します。スタイル付けや焼き込みは後続の工程で行います。

まず最も正確なテキストを入手する

精度は出発点に依存します。

  • ナレーションスクリプトが存在する場合、それを正解データとして使用します。 技術用語や UI ラベルについてはすでに正確です。ゼロから文字起こしするよりも、音声に合わせてアラインします。
  • それ以外の場合は音声を文字起こし(Whisper、プラットフォームの自動キャプション、その他の ASR)し、映像に合わせて修正します。ASR は製品名、コード、略語を高確率で誤認識します。画面上の表記と完全に一致するよう、ひとつひとつ修正してください。

未修正の ASR 出力をそのまま使わないでください。誤りは必ず最も重要な単語に集中しています。

キューを発話に合わせてタイミング調整する

  • 各キューは該当する行が話されているときに表示され、終了すると消えます。発話に合わせ、任意の間隔ではありません。
  • 最小表示時間は約 1 秒(短いキューでも)、最大約 7 秒。それを超えるものは分割します。
  • 文中にギャップを入れないでください。文と文の間の小さなギャップは問題なく、読みやすさを向上させます。

行数と読みやすさのルール

  • 1 キューあたり 1~2 行、3 行以上は不可。
  • 1 行あたり約 32~42 文字。それを超えると画面に収まらず、安全領域をはみ出します。
  • 読み速度は約 17 文字/秒以下(約 160~180 wpm)。超える場合、単語が高速で流れてしまうため、キューを分割するか表示時間を延長してください。
  • 行は節の境界で区切り、フレーズの途中で分割しないでください。「設定 ページ」はまとめて保持し、「設定」だけを一行に残さないでください。

形式を選択する

  • SRT - 汎用的、インデックス + HH:MM:SS,mmm --> HH:MM:SS,mmm + テキスト。多くのプラットフォームやエディターへのアップロードに使用します。
  • WebVTT (.vtt) - WEBVTT ヘッダー、HH:MM:SS.mmm タイムスタンプ、キューごとの位置・スタイル指定に対応。HTML5 の <track> やウェブプレイヤーに使用します。

有効でパース可能な出力を生成してください。正しいタイムスタンプの句読点(SRT ではミリ秒前にカンマ、VTT ではピリオド)、キュー間の空行、末尾の空白なし。

クリーン版か逐語版か

チュートリアルではクリーン版キャプションを使用します。「えーと」「あのー」、言い間違いなどのフィラーは削除し、意味はそのまま保持します。技術用語、コード、UI ラベルは正確に残します。逐語版(厳密な文字起こし)は、ユーザーが明示的に必要とする場合(法務、研究、正確な引用の文脈)のみ使用します。

同期の品質確認

動画の実際の映像と、開始点・中間点・終了点でスポットチェックを行います。ズレが蓄積していないか確認します。各キューが該当行に正しく表示され、次のキューが始まる前に消えていることを確認します。誤ったショットにキャプションが残っている場合は修正してください。

引き継ぎ

完成した .srt / .vtt は、social-video-formatter に渡して焼き込みやプラットフォーム用スタイル付けを行うか、ウェブプレイヤーの <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.

関連スキル