Communitygithub.com

비디오 프로세서

오디오 추출, 형식 변환(mp4, webm) 및 Whisper 음성 인식 기능을 통해 비디오 파일을 처리합니다. 사용자가 비디오 변환, 오디오 추출, 음성 인식, mp4, webm, ffmpeg 또는 whisper 음성 인식 등을 언급할 때 사용하세요.

비디오 프로세서란 무엇인가요?

이 스킬은 FFmpeg과 OpenAI의 Whisper 모델을 활용하여 비디오 파일 처리를 위한 통합 인터페이스를 제공합니다. 주요 기능으로는 비디오에서 오디오 추출, MP4 및 WebM 형식으로의 변환, 다양한 출력 형식(txt, srt, vtt, json)으로의 음성 인식 기능이 포함됩니다. CLI 기반의 `video_processor.py` 스크립트 하나로 모든 작업을 처리하며, 사용자는 간단한 명령어로 모델 크기(tiny, base, small, medium, large)와 언어 코드를 설정할 수 있습니다. Claude Code, Cursor, Codex 등 uv 런타임을 지원하는 모든 환경에서 사용 가능하며, 자동 임시 파일 정리 및 종합적인 오류 처리를 통해 안정적인 워크플로우를 제공합니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/bg-szy/TOP-SKILLS/tree/HEAD/skills/marketplace/video-processor

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

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

문서

비디오 프로세서은(는) 무엇을 하나요?

지침

이 스킬은 FFmpeg와 OpenAI의 Whisper 모델을 사용하여 오디오 추출, 형식 변환 및 오디오 음성 인식을 포함한 비디오 처리 유틸리티를 제공합니다.

사전 요구 사항

필수 도구 (환경에 설치되어 있어야 함):

  • FFmpeg: 비디오/오디오 처리를 위한 멀티미디어 프레임워크

    # macOS
    brew install ffmpeg
    
    # Ubuntu/Debian
    apt-get install ffmpeg
    
    # 설치 확인
    ffmpeg -version
    
  • OpenAI Whisper: 음성을 텍스트로 변환하는 모델

    # pip로 설치
    pip install -U openai-whisper
    
    # 설치 확인
    whisper --help
    

Python 패키지 (PEP 723을 통해 스크립트에 포함):

  • click (CLI 프레임워크)
  • ffmpeg-python (FFmpeg용 Python 래퍼)

워크플로우

모든 비디오 처리 작업에는 scripts/video_processor.py 스크립트를 사용하세요. 이 스크립트는 다음과 같은 명령어를 가진 간단한 CLI를 제공합니다.

1. 비디오에서 오디오 추출

비디오 파일에서 오디오 트랙을 추출합니다.

uv run .claude/skills/video-processor/scripts/video_processor.py extract-audio input.mp4 output.wav

옵션:

  • --format: 출력 오디오 형식 (기본값: wav). 지원 형식: wav, mp3, aac, flac
  • 출력은 음성 인식 또는 독립형 오디오 사용에 적합합니다.

2. 비디오를 MP4로 변환

모든 비디오 파일을 MP4 형식으로 변환합니다.

uv run .claude/skills/video-processor/scripts/video_processor.py to-mp4 input.avi output.mp4

옵션:

  • --codec: 비디오 코덱 (기본값: libx264). 일반 옵션: libx264, libx265, h264
  • --preset: 인코딩 속도/품질 프리셋 (기본값: medium). 옵션: ultrafast, fast, medium, slow, veryslow

3. 비디오를 WebM으로 변환

모든 비디오 파일을 WebM 형식(웹 최적화)으로 변환합니다.

uv run .claude/skills/video-processor/scripts/video_processor.py to-webm input.mp4 output.webm

옵션:

  • --codec: 비디오 코덱 (기본값: libvpx-vp9). 옵션: libvpx, libvpx-vp9
  • WebM은 웹 재생 및 스트리밍에 최적화되어 있습니다.

4. Whisper로 오디오 음성 인식

OpenAI의 Whisper 모델을 사용하여 오디오 또는 비디오 파일을 텍스트로 변환합니다.

# 비디오 파일 음성 인식 (오디오가 자동으로 추출됨)
uv run .claude/skills/video-processor/scripts/video_processor.py transcribe input.mp4 transcript.txt

# 오디오 파일 직접 음성 인식
uv run .claude/skills/video-processor/scripts/video_processor.py transcribe audio.wav transcript.txt

옵션:

  • --model: Whisper 모델 크기 (기본값: base). 옵션:
    • tiny: 가장 빠름, 가장 낮은 정확도 (~1GB RAM)
    • base: 빠름, 좋은 정확도 (~1GB RAM) [기본값]
    • small: 균형 잡힘 (~2GB RAM)
    • medium: 높은 정확도 (~5GB RAM)
    • large: 최고 정확도, 가장 느림 (~10GB RAM)
  • --language: 언어 코드 (기본값: 자동 감지). 예: en, es, fr, de, zh
  • --format: 출력 형식 (기본값: txt). 옵션: txt, srt, vtt, json

음성 인식 워크플로우:

  1. 입력이 비디오인 경우 FFmpeg가 임시 WAV 파일로 오디오를 추출합니다.
  2. Whisper가 오디오 파일을 처리합니다.
  3. 음성 인식 결과가 요청된 형식으로 저장됩니다.
  4. 임시 파일은 자동으로 정리됩니다.

5. 통합 워크플로우 예제

비디오를 처음부터 끝까지 처리합니다.

# 1. 분석을 위해 오디오 추출
uv run .claude/skills/video-processor/scripts/video_processor.py extract-audio lecture.mp4 lecture.wav

# 2. SRT 자막으로 음성 인식
uv run .claude/skills/video-processor/scripts/video_processor.py transcribe lecture.mp4 lecture.srt --format srt --model small

# 3. 웹 형식으로 변환
uv run .claude/skills/video-processor/scripts/video_processor.py to-webm lecture.mp4 lecture.webm

주요 기술 세부 사항

FFmpeg와 Whisper 통합:

  • FFmpeg 자체는 오디오를 음성 인식하지 않으며, 외부 음성 인식을 위해 오디오를 준비합니다.
  • 워크플로우: 오디오 추출(FFmpeg) → 음성 인식(Whisper) → 선택 사항: 비디오와 재통합
  • FFmpeg는 실시간 처리를 위해 오디오를 Whisper로 직접 파이프할 수 있습니다(고급 사용 사례).

음성 인식을 위한 오디오 형식:

  • Whisper는 WAV 또는 MP3 형식에서 가장 잘 작동합니다.
  • 샘플 속도: 16kHz가 최적입니다(스크립트가 자동으로 변환 처리).
  • 스크립트는 Whisper에 최적화된 설정으로 오디오를 추출합니다.

출력 형식:

  • txt: 일반 텍스트 문서
  • srt: SubRip 자막 형식(타임스탬프 포함)
  • vtt: WebVTT 자막 형식(웹 표준)
  • json: 단어 수준 타임스탬프를 포함한 상세 JSON

오류 처리

이 스크립트는 포괄적인 오류 처리를 포함합니다.

  • 입력 파일 존재 여부 확인
  • FFmpeg 및 Whisper 설치 여부 확인
  • 종속성 누락 시 명확한 오류 메시지 제공
  • 오류 발생 시 임시 파일 정리 처리

성능 팁

  • 빠른 초안에는 tiny 또는 base 모델을 사용하세요.
  • 프로덕션 음성 인식에는 small 또는 medium을 사용하세요.
  • 최대 정확도가 필요한 경우에만 large를 사용하세요.
  • 긴 비디오의 경우 먼저 오디오를 추출한 다음 세그먼트별로 음성 인식하는 것을 고려하세요.
  • VP9를 사용한 WebM 변환은 더 오래 걸리지만 파일 크기가 더 작습니다.

예제

예제 1: 빠른 비디오를 MP4로 변환

사용자 요청:

오래된 카메라에서 AVI 파일이 있습니다. MP4로 변환해 주시겠어요?

다음과 같이 수행합니다.

  1. 기본 설정으로 to-mp4 명령어 사용:
    uv run .claude/skills/video-processor/scripts/video_processor.py to-mp4 old_video.avi output.mp4
    
  2. 변환이 성공적으로 완료되었는지 확인
  3. 출력 파일 위치를 사용자에게 알림

예제 2: 오디오 추출 및 음성 인식

사용자 요청:

강의 비디오를 녹화했는데 문서가 필요합니다. 오디오를 추출하고 음성 인식해 주시겠어요?

다음과 같이 수행합니다.

  1. 먼저 오디오 추출:
    uv run .claude/skills/video-processor/scripts/video_processor.py extract-audio lecture.mp4 lecture.wav
    
  2. 그런 다음 base 모델(속도와 정확도의 좋은 균형)을 사용하여 음성 인식:
    uv run .claude/skills/video-processor/scripts/video_processor.py transcribe lecture.mp4 transcript.txt --model base
    
  3. transcript.txt 파일을 사용자와 공유

예제 3: 자막이 포함된 웹 최적화 비디오 생성

사용자 요청:

웹사이트에 자막과 함께 이 비디오를 올려야 합니다. 도와주시겠어요?

다음과 같이 수행합니다.

  1. 웹 최적화를 위해 WebM으로 변환:
    uv run .claude/skills/video-processor/scripts/video_processor.py to-webm presentation.mp4 presentation.webm
    
  2. SRT 자막 파일 생성:
    uv run .claude/skills/video-processor/scripts/video_processor.py transcribe presentation.mp4 subtitles.srt --format srt --model small
    
  3. 사용자에게 다음 파일이 있음을 알림:
    • presentation.webm (웹 최적화 비디오)
    • subtitles.srt (임베딩용 자막 파일)

예제 4: 언어 지정 고품질 음성 인식

사용자 요청:

출판용으로 정확한 문서가 필요한 스페인어 인터뷰 비디오가 있습니다.

다음과 같이 수행합니다.

  1. 최고 정확도를 위해 더 큰 모델과 언어 지정 사용:
    uv run .claude/skills/video-processor/scripts/video_processor.py transcribe interview.mp4 transcript.txt --model medium --language es
    
  2. 선택 사항으로 검토용 SRT 생성:
    uv run .claude/skills/video-processor/scripts/video_processor.py transcribe interview.mp4 transcript.srt --format srt --model medium --language es
    
  3. 사용자와 문서를 검토하고 필요한 수정 사항 적용

예제 5: 여러 비디오 일괄 처리

사용자 요청:

모두 WebM으로 변환하고 음성 인식해야 하는 교육 비디오 폴더가 있습니다.

다음과 같이 수행합니다.

  1. 디렉터리의 모든 비디오 파일 나열:
    ls training_videos/*.mp4
    
  2. 각 비디오 파일에 대해 변환 및 음성 인식 실행:
    # 각 비디오: video1.mp4, video2.mp4 등
    uv run .claude/skills/video-processor/scripts/video_processor.py to-webm training_videos/video1.mp4 output/video1.webm
    uv run .claude/skills/video-processor/scripts/video_processor.py transcribe training_videos/video1.mp4 output/video1.txt --model base
    
    # 각 파일에 대해 반복
    
  3. 모든 변환 및 음성 인식이 완료되었는지 확인
  4. 출력 파일 요약 제공

요약

video-processor 스킬은 일반적인 비디오 처리 작업을 위한 통합 인터페이스를 제공합니다.

  • 오디오 추출: 다양한 형식의 오디오 트랙 추출
  • 형식 변환: MP4(범용) 또는 WebM(웹 최적화)으로 변환
  • 음성 인식: 여러 출력 형식의 음성을 텍스트로 변환
  • 유연성: 모델 선택, 언어 및 출력 형식을 위한 CLI 인수

모든 작업은 합리적인 기본값과 포괄적인 오류 처리를 갖춘 단일의 잘 문서화된 스크립트를 통해 처리됩니다.

Individual skills in this repo

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

bg-szy/TOP-SKILLS

Brand-first landing page designer — runs a brand-identity interview (colors, typography, shape language), then generates and iterates on a polished landing page via Stitch with deployment-ready HTML. Use when the user asks to create, design, or build a landing page, homepage, or marketing page and has no established visual direction. Skip when they have a design mockup, need a dashboard or app UI, are working at component level, building a multi-page app, or restyling with known design tokens — use frontend-design instead.

bg-szy/TOP-SKILLS

Fill out Microsoft Azure Landing Zone (ALZ) Accelerator checklists by interviewing the user, mapping their Azure subscriptions, integrating IP addressing documentation, and applying Microsoft Cloud Adoption Framework best practices. Produces a completed Excel checklist (.xlsx) ready for ALZ deployment. Use this skill whenever the user mentions Azure Landing Zone, ALZ checklist, landing zone accelerator, platform landing zone configuration, ALZ bootstrap, hub-and-spoke setup, Azure network topology planning, or wants to fill out any ALZ-related checklist or configuration file. Also trigger when the user uploads an Excel file that contains tabs like "Accelerator - Bootstrap", "Accelerator - Bicep", or "Accelerator - Terraform".

bg-szy/TOP-SKILLS

Compose a premium, animated landing page section by section in Next.js + Tailwind + Motion (Framer Motion) — built on a real design system, with editorial copy and motion that feels human-crafted, not template-generated. Use when building or rebuilding a landing page, marketing site, or hero/feature/pricing/CTA sections that need to look production-ready and bespoke from day one.

bg-szy/TOP-SKILLS

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

bg-szy/TOP-SKILLS

Optimize landing pages for conversions, performance, and SEO. Use when improving landing pages, increasing conversions, or optimizing page performance.

bg-szy/TOP-SKILLS

Review investment portfolios for risk, diversification, fees. Asset allocation recommendations, tax-loss harvesting, rebalancing.

bg-szy/TOP-SKILLS

Beads Viewer - Graph-aware triage engine for Beads projects. Computes PageRank, betweenness, critical path, and cycles. Use --robot-* flags for AI agents.

bg-szy/TOP-SKILLS

CI red? Call us. Pipeline fire brigade deploys. Use when user mentions CI failures, build errors, test failures, or pipeline issues. Do NOT load for: local builds, standard implementation work, reviews, or setup.

bg-szy/TOP-SKILLS

CASS Memory System - procedural memory for AI coding agents. Three-layer cognitive architecture with confidence decay, anti-pattern learning, cross-agent knowledge transfer, trauma guard safety system. Bun/TypeScript CLI.

bg-szy/TOP-SKILLS

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

bg-szy/TOP-SKILLS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

bg-szy/TOP-SKILLS

Use when the user asks to "pre-launch check the landing page", "run a Quality-Score preflight", or "verify ad-to-page message match before launch"; produces an ad↔page continuity report — message-match gaps, above-the-fold check, page-speed read, form-friction count, mobile-render flags — as a pass/fix punch list. Not for redesigning or rewriting the page — use landing-optimizer; not for scoring the account or the RQS — use ad-account-auditor. 落地页体验预检/广告落地页一致性检查

bg-szy/TOP-SKILLS

Use when the user asks to "optimize our landing page for influencer traffic", "fix our promo-code landing page", or "improve conversion from a creator campaign"; produces a message-match audit, page-structure and social-proof recommendations, a promo-code/CTA conversion plan, and an A/B test roadmap. Not for measuring campaign results after launch — use performance-analyzer.

bg-szy/TOP-SKILLS

Audit a landing page, sales page or checkout page for conversion leaks and return a fix list ordered by expected revenue impact. Use when asked to review, critique or improve a landing page, sales page, opt-in page, product page or checkout flow, when conversion rate is low, when paid traffic is not converting, or when someone asks "why isn't this page converting" or wants a CRO / landing page review.

bg-szy/TOP-SKILLS

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

bg-szy/TOP-SKILLS

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

bg-szy/TOP-SKILLS

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

bg-szy/TOP-SKILLS

Account assets, equity and fund positions, P&L, cash flow records, account statements, margin ratios, buy-power estimates, order management, and DCA recurring investments via Longbridge (most require Trade permission). Frameworks: portfolio diagnosis, rebalancing, asset allocation, risk analysis (VaR/CVaR), performance attribution, and tax-loss harvesting. Triggers: "持仓", "账户", "盈亏", "资产", "对账单", "下单", "买入", "卖出", "撤单", "定投", "组合诊断", "再平衡", "资产配置", "风险分析", "绩效归因", "税损收割", "持倉", "賬戶", "盈虧", "對賬單", "下單", "買入", "賣出", "組合診斷", "再平衡", "稅損收割", "positions", "portfolio", "P&L", "order", "buy", "sell", "DCA", "statement", "risk analysis", "rebalancing", "tax harvesting", "我的风险", "持仓风险", "风险敞口", "資產", "資產配置", "風險分析", "績效歸因", "撤單

bg-szy/TOP-SKILLS

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

bg-szy/TOP-SKILLS

Using the Wonda CLI to generate images, videos, music, and audio from the terminal — plus LinkedIn, Reddit, and X/Twitter research and automation

관련 스킬