Communitygithub.com

JantonioFC/skillsbank

MP4 비디오에서 설정 가능한 간격으로 키 프레임을 추출하고, Tesseract OCR을 실행하여 비디오 메타데이터와 타임스탬프가 포함된 텍스트 전사로 구성된 구조화된 Markdown 보고서를 생성합니다.

skillsbank란 무엇인가요?

이 스킬은 MP4 비디오 파일에서 키 프레임을 자동으로 추출하고, 각 프레임에 대해 OCR 텍스트 인식을 수행하며, 구조화된 Markdown 보고서를 생성합니다. 보고서에는 비디오 메타데이터(지속 시간, 해상도, 코덱)와 타임스탬프가 포함된 프레임별 OCR 전사가 포함됩니다. Codex CLI용으로 설계되었으며, 로컬 머신에 FFmpeg와 Tesseract OCR이 설치되어 있어야 합니다. 이 스킬은 비디오 프레젠테이션, 강의, 또는 스크린캐스트에서 텍스트 콘텐츠를 추출하거나, 내장 자막이 없는 비디오 파일에서 검색 가능한 전사를 생성해야 할 때 유용합니다. 기본적으로 30초 간격으로 프레임을 추출하며, 사용자 정의 간격과 언어 팩을 지원하여 다국어 콘텐츠 처리도 가능합니다. 모든 처리는 로컬에서 이루어지며 네트워크 전송이 없어 보안에 안전합니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/JantonioFC/skillsbank/tree/HEAD/skills/video-content-extractor

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

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

문서

비디오 콘텐츠 추출기

개요

MP4 비디오 파일에서 설정 가능한 시간 간격으로 키 프레임을 자동으로 추출하고, 각 프레임에 대해 OCR 텍스트 인식을 수행하며, 구조화된 Markdown 보고서를 생성합니다. 보고서에는 비디오 메타데이터(지속 시간, 해상도, 코덱)와 타임스탬프 참조가 포함된 프레임별 OCR 전사가 포함됩니다.

이 스킬은 Codex CLI용으로 설계되었으며, 로컬 머신에 FFmpeg와 Tesseract OCR이 설치되어 있어야 합니다.

이 스킬을 사용해야 하는 경우

  • 비디오 프레젠테이션, 강의 또는 스크린캐스트에서 텍스트 콘텐츠를 추출해야 할 때 사용하세요.
  • 내장 자막이 없는 비디오 파일에서 검색 가능한 전사를 생성하려 할 때 사용하세요.
  • 비디오 콘텐츠를 프로그래밍 방식으로 분석하고 구조화된 요약을 생성해야 할 때 사용하세요.
  • 사용자가 "화면에 무엇이 표시되어 있는지 읽어줘" 또는 "이 비디오에서 콘텐츠를 추출해줘"라고 요청할 때 사용하세요.

작동 방식

1단계: 비디오 메타데이터 분석

스킬은 ffprobe를 사용하여 비디오 메타데이터(지속 시간, 해상도, 프레임 속도, 코덱 정보, 파일 크기)를 추출합니다.

2단계: 키 프레임 추출

FFmpeg를 사용하여 스킬은 설정된 간격(기본값: 30초마다)으로 프레임을 캡처합니다. 각 프레임은 타임스탬프가 포함된 JPEG 이미지로 저장됩니다.

3단계: OCR 텍스트 인식

추출된 각 프레임은 Tesseract OCR로 처리됩니다. 기본 PSM 모드에서 의미 있는 텍스트를 반환하지 않으면 완전 자동 페이지 분할로 대체됩니다.

4단계: Markdown 보고서 생성

추출된 모든 데이터는 구조화된 Markdown 문서로 조합됩니다.

예제

예제 1: 기본 추출

에이전트 프롬프트: video-content-extractor 스킬을 사용하여 lecture.mp4에서 콘텐츠를 추출해줘

출력은 lecture.md 파일과 lecture_frames/ 디렉토리를 생성합니다.

예제 2: 사용자 정의 간격

매개변수: video_path, output_dir, interval(seconds), lang 60초마다 추출하고 영어 전용 OCR 사용: python scripts/extract_video.py recording.mp4 ./output 60 eng

예제 3: 이중 언어 콘텐츠

기본 중국어 + 영어 OCR로 추출: python scripts/extract_video.py lecture.mp4 . 15 chi_sim+eng

모범 사례

  • 텍스트 변경이 빈번한 빠른 콘텐츠에는 짧은 간격(10-15초)을 사용하세요.
  • 중복 프레임을 줄이기 위해 프레젠테이션 슬라이드나 느린 강의에는 긴 간격(30-60초)을 사용하세요.
  • 중국어 콘텐츠의 경우 Tesseract 중국어 언어 팩(chi_sim)이 설치되어 있는지 확인하세요.

제한 사항

  • FFmpeg와 Tesseract OCR이 설치되어 있고 PATH를 통해 접근 가능해야 합니다.
  • Tesseract OCR 정확도는 비디오 품질, 텍스트 크기 및 글꼴 선명도에 따라 달라집니다.
  • 오디오를 추출하거나 음성을 텍스트로 변환하는 기능은 없습니다.
  • 프레임 추출은 장면 변경 기반이 아닌 시간 기반이므로 거의 중복된 프레임이 생성될 수 있습니다.
  • 짧은 간격의 대용량 비디오는 많은 프레임을 생성할 수 있으므로 충분한 디스크 공간을 확보하세요.

보안 및 안전 참고 사항

  • 이 스킬은 비디오 파일만 읽고 추출된 프레임과 Markdown 보고서를 씁니다.
  • 네트워크를 통해 데이터를 전송하지 않습니다. 모든 처리는 로컬에서 이루어집니다.
  • FFmpeg와 Tesseract는 고정되고 사전 검증된 인수로 호출됩니다.
  • 이 스킬은 원본 비디오 파일을 수정하거나 삭제하지 않습니다.

일반적인 실수와 해결 방법

  • 문제: Tesseract가 왜곡된 텍스트를 반환합니다. 해결 방법: 올바른 언어 팩이 설치되어 있는지 확인하세요. tesseract --list-langs를 실행하여 확인하세요.

  • 문제: FFmpeg가 "찾을 수 없음" 오류와 함께 실패합니다. 해결 방법: FFmpeg가 PATH에 있는지 확인하세요. ffmpeg -version을 실행하여 확인하세요.

  • 문제: 대용량 비디오에서 OCR이 느립니다. 해결 방법: 간격 매개변수를 늘려 처리되는 프레임 수를 줄이세요.

관련 스킬

  • @media-summarizer - 시각적 및 오디오 단서를 사용하여 비디오 콘텐츠를 요약합니다.
  • @document-ocr - 비디오 처리 없이 정적 이미지나 스캔된 문서에 대해 OCR을 수행합니다.

Individual skills in this repo

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

JantonioFC/skillsbank

AI-powered image editing with style transfer and object removal

JantonioFC/skillsbank

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

JantonioFC/skillsbank

Analise e auditoria de editais de leilao judicial e extrajudicial. Riscos ocultos, clausulas perigosas, debitos, ocupante e classificacao da oportunidade.

JantonioFC/skillsbank

Embed Photopea in web apps using photopea.js. Covers embedding, file I/O, scripting, exporting, layers, text, filters, and the full Photoshop-compatible API.

JantonioFC/skillsbank

Best practices for Remotion - Video creation in React

JantonioFC/skillsbank

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

JantonioFC/skillsbank

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

JantonioFC/skillsbank

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

JantonioFC/skillsbank

Video and audio perception, indexing, and editing. Ingest files/URLs/live streams, build visual/spoken indexes, search with timestamps, edit timelines, add overlays/subtitles, generate media, and create real-time alerts.

JantonioFC/skillsbank

Upload, stream, search, edit, transcribe, and generate AI video and audio using the VideoDB SDK.

JantonioFC/skillsbank

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

JantonioFC/skillsbank

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.

JantonioFC/skillsbank

Tool lifecycle UI components for React/Next.js from ui.inference.sh. Display tool calls: pending, progress, approval required, results. Capabilities: tool status, progress indicators, approval flows, results display. Use for: showing agent tool calls, human-in-the-loop approvals, tool output. Triggers: tool ui, tool calls, tool status, tool approval, tool results, agent tools, mcp tools ui, function calling ui, tool lifecycle, tool pending

JantonioFC/skillsbank

Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

JantonioFC/skillsbank

When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms. Also use when the user mentions 'PPC,' 'paid media,' 'ROAS,' 'CPA,' 'ad campaign,' 'retargeting,' 'audience targeting,' 'Google Ads,' 'Facebook ads,'...

JantonioFC/skillsbank

Create AI avatar and talking head videos with OmniHuman, Fabric, PixVerse via inference.sh CLI. Models: OmniHuman 1.5, OmniHuman 1.0, Fabric 1.0, PixVerse Lipsync. Capabilities: audio-driven avatars, lipsync videos, talking head generation, virtual presenters. Use for: AI presenters, expla...

JantonioFC/skillsbank

Create AI marketing videos for ads, promos, product launches, and brand content. Models: Veo, Seedance, Wan, FLUX for visuals, Kokoro for voiceover. Types: product demos, testimonials, explainers, social ads, brand videos. Use for: Facebook ads, YouTube ads, product launches, brand awarene...

JantonioFC/skillsbank

Generate AI videos with Google Veo, Seedance, Wan, Grok and 40+ models via inference.sh CLI. Models: Veo 3.1, Veo 3, Seedance 1.5 Pro, Wan 2.5, Grok Imagine Video, OmniHuman, Fabric, HunyuanVideo. Capabilities: text-to-video, image-to-video, lipsync, avatar animation, video upscaling, fole...

JantonioFC/skillsbank

Production-ready CI/CD configurations for Playwright — GitHub Actions, GitLab CI, CircleCI, Azure DevOps, Jenkins, Docker, parallel sharding, reporting, code coverage, and global setup/teardown.

JantonioFC/skillsbank

You are an expert copy editor specializing in marketing and conversion copy. Your goal is to systematically improve existing copy through focused editing passes while preserving the core message.

관련 스킬