Communitygithub.com

비디오 프로세서

비디오 파일 처리(오디오 추출, 포맷 변환(MP4, WebM), Whisper를 이용한 텍스트 변환)를 제공합니다. 사용자가 비디오 변환, 오디오 추출, 텍스트 변환, MP4, WebM, ffmpeg 또는 Whisper 텍스트 변환을 언급할 때 사용하세요.

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

이 스킬은 FFmpeg와 OpenAI의 Whisper 모델을 활용하여 비디오 파일 처리를 위한 포괄적인 도구 모음을 제공합니다. 주요 기능으로는 비디오에서 오디오 트랙 추출, 다양한 비디오 포맷 변환(MP4, WebM), Whisper를 사용한 오디오 텍스트 변환이 있습니다. Claude Code, Cursor와 같은 AI 어시스턴트와 함께 사용하도록 설계되었으며, PEP 723을 통해 필요한 Python 패키지(click, ffmpeg-python)를 자동으로 관리하는 통합 CLI 스크립트(`scripts/video_processor.py`)를 제공합니다. 워크플로는 간단하며, 다양한 모델 크기(tiny부터 large까지)와 언어를 지원하고, 여러 출력 형식(txt, SRT, VTT, JSON)을 제공합니다. 이 스킬을 사용하면 AI 어시스턴트가 비디오 처리 작업을 일관되고 정확하게 수행할 수 있어, 사용자의 요청에 따라 효율적인 미디어 변환과 텍스트 변환을 자동화할 수 있습니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/aiskillstore/marketplace/tree/HEAD/skills/egadams/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. 출력 파일 요약을 제공하세요.

요약

비디오 프로세서 스킬은 일반적인 비디오 처리 작업을 위한 통합 인터페이스를 제공합니다:

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

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

Individual skills in this repo

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

aiskillstore/marketplace

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.

aiskillstore/marketplace

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.

aiskillstore/marketplace

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. 落地页体验预检/广告落地页一致性检查

aiskillstore/marketplace

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.

aiskillstore/marketplace

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.

aiskillstore/marketplace

This skill helps users extract GitHub repository project details and contributor contact information using keywords, stars, and update dates. Agent should proactively apply this skill when users express needs like search for GitHub projects by keywords, find top open-source contributors in specific domains, extract developer contacts from GitHub repositories, discover trending repositories with high stars, gather contributor profiles and social links for tech recruiting, retrieve GitHub project descriptions and metrics, build developer communities by finding active contributors, search for repositories updated recently, collect personal website and Twitter links of developers, generate targeted leads for developer tools, or track active open-source contributors for collaboration.

aiskillstore/marketplace

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

aiskillstore/marketplace

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

aiskillstore/marketplace

Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. When Claude needs to work with professional documents (.docx files) for: (1) Creating new documents, (2) Modifying or editing content, (3) Working with tracked changes, (4) Adding comments, or any other document tasks

aiskillstore/marketplace

Generates creative domain name ideas for your project and checks availability across multiple TLDs (.com, .io, .dev, .ai, etc.). Saves hours of brainstorming and manual checking.

aiskillstore/marketplace

Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, or transparent-background cutouts. Use when Codex should create a brand-new image, transform an existing image, or derive visual variants from references, and the output should be a bitmap asset rather than repo-native code or vector. Do not use when the task is better handled by editing existing SVG/vector/code-native assets, extending an established icon or logo system, or building the visual directly in HTML/CSS/canvas.

aiskillstore/marketplace

A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project updates, etc.).

aiskillstore/marketplace

Router skill for LLMQuant portfolio workflows. Use when the user needs company profiles, thesis tracking, theme research, watchlist monitoring, or alert management.

aiskillstore/marketplace

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", "我的风险", "持仓风险", "风险敞口", "資產", "資產配置", "風險分析", "績效歸因", "撤單

aiskillstore/marketplace

Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).

aiskillstore/marketplace

Use for Codex models/pricing, scheduled tasks, skills, settings, setup, troubleshooting, customization, automations, and self-knowledge—including 'you,' 'your,' 'this app,' or 'this coding agent' when they refer to Codex—and for OpenAI APIs/products and ChatGPT Work. Also use for model choice/migration, prompting, SDKs, Responses, Realtime, agents, evals, and Chat/Work/Codex comparisons. Do not use for generic app/software tasks that merely mention Codex.

aiskillstore/marketplace

Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms. When Claude needs to fill in a PDF form or programmatically process, generate, or analyze PDF documents at scale.

aiskillstore/marketplace

Presentation creation, editing, and analysis. When Claude needs to work with presentations (.pptx files) for: (1) Creating new presentations, (2) Modifying or editing content, (3) Working with layouts, (4) Adding comments or speaker notes, or any other presentation tasks

aiskillstore/marketplace

Perform a read-only, defect-first review of a specified code change and return every actionable finding. Use when another agent delegates review of uncommitted changes, a base-branch diff, a commit, or custom review instructions.

aiskillstore/marketplace

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.

관련 스킬