Communitygithub.com

aktsmm/Agent-Skills - 비디오 관찰

비디오 URL 또는 로컬 비디오 파일에서 자막, 샘플링된 프레임, 콘택트 시트 및 프롬프트 패킷을 추출하여 GitHub Copilot 분석을 준비합니다. 사용자가 Copilot에게 YouTube/Loom/TikTok/X/Vimeo URL 또는 .mp4/.mov/.mkv/.webm 파일 등 비디오, 화면 녹화, 데모, 웨비나를 시청, 검사, 요약 또는 진단하도록 요청할 때 사용합니다.

Agent-Skills - 비디오 관찰란 무엇인가요?

이 스킬은 GitHub Copilot이 비디오 콘텐츠를 분석할 수 있도록 자막, 프레임 콘택트 시트, 프레임 인덱스, 매니페스트 및 프롬프트 패킷을 생성하는 'Video Watch' 도구입니다. 주로 Claude Code 용으로 설계된 `bradautomates/claude-video`에서 영감을 받았지만, GitHub Copilot 워크플로우에 특화되어 있습니다. 핵심 워크플로우는 사전 검사 스크립트를 실행하여 종속성을 확인한 후, 비디오 URL이나 로컬 파일을 입력으로 받아 분석에 필요한 모든 아티팩트를 생성하는 video_watch.py 스크립트를 실행하는 것입니다. 다양한 세부 모드(자막 전용, 효율적인 시각적 검사, 균형 잡힌 기본값, 광범위한 시각적 검사)를 지원하며, 생성된 아티팩트를 순서대로 읽어 질문에 답변합니다. 이 스킬은 DRM 우회, 인증, 또는 개인 미디어 자격 증명을 요구하지 않으며, 공식 API나 기존 트랜스크립트로 충분한 경우 더 가벼운 경로를 권장합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aktsmm/Agent-Skills/tree/HEAD/video-watch

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

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

문서

비디오 관찰

GitHub Copilot이 검사할 수 있는 비디오 아티팩트(자막, 프레임 콘택트 시트, 프레임 인덱스, 매니페스트, 프롬프트 패킷)를 준비합니다.

이 스킬은 bradautomates/claude-video에서 영감을 받았지만, GitHub Copilot 워크플로우를 대상으로 합니다. Claude Code의 Read 병렬 처리를 가정하지 마십시오. 먼저 파일을 생성한 후, 사용자의 질문에 필요한 아티팩트만 검사하십시오.

사용 시기

  • 사용자가 비디오를 시청, 검사, 요약, 비교 또는 진단하도록 요청합니다.
  • 입력이 yt-dlp가 지원하는 비디오 URL 또는 로컬 .mp4, .mov, .mkv, .webm 파일입니다.
  • 작업이 말로 설명되는 내용과 화면에 표시되는 내용 모두에 의존하는 경우(예: 버그 재현, 제품 데모, 출시 비디오, 튜토리얼, 웨비나, 광고, 화면 녹화).

적합하지 않은 경우

  • DRM, 페이월, 인증 또는 사이트 이용 약관을 우회하지 마십시오.
  • 쿠키, 베어러 토큰, 서명된 URL 또는 개인 미디어 자격 증명을 요청하거나 저장하지 마십시오.
  • 공식 API나 기존 트랜스크립트가 비디오 처리 없이 작업을 해결할 수 있다면 더 가벼운 경로를 선호하십시오.

핵심 워크플로우

  1. 종속성이 확실하지 않은 경우 사전 검사를 실행합니다: python .github/skills/video-watch/scripts/preflight.py URL 입력의 경우 python .github/skills/video-watch/scripts/preflight.py --url-mode를 사용합니다.
  2. 아티팩트를 생성합니다: python .github/skills/video-watch/scripts/video_watch.py <url-또는-경로> --question "<답변할 내용>" 다른 도구, Azure Speech, 또는 Speech Translator Desktop Plus가 이미 트랜스크립트를 생성한 경우 --transcript-file <경로>를 사용합니다. 비공개 또는 인증된 미디어의 경우 --detail transcript --metadata-only --transcript-file <경로>를 선호하고 쿠키, 베어러 토큰 또는 서명된 URL 자격 증명을 전달하지 마십시오.
  3. 다음 순서로 아티팩트를 읽습니다: manifest.json → prompt.md → transcript.md → frame-index.md → contact-sheet.jpg → 필요한 경우에만 frames/의 선택된 파일. manifest.json은 로컬 소스 바이트 또는 다운로드가 발생한 경우 다운로드된 URL 비디오 바이트에 대한 SHA-256을 기록합니다. 메타데이터 전용 URL 실행은 미디어를 가져오지 않고 해시를 null로 남깁니다.
  4. 아티팩트에서 답변합니다. 답변이 트랜스크립트 전용, 프레임 전용 또는 희소 샘플링으로 제한되는 경우 명시합니다.
  5. 특정 순간의 경우 --start / --end를 사용하여 프레임 예산에 집중하도록 다시 실행합니다.

세부 모드

모드사용
transcript자막 또는 사이드카 트랜스크립트만 해당. 가장 빠름.
efficient빠른 분류를 위한 작은 시각적 패스.
balanced대부분의 화면 녹화 및 데모를 위한 기본 콘택트 시트.
token-burner사용자가 광범위한 시각적 범위를 명시적으로 필요로 할 때 더 큰 시각적 패스.

러버 덕 체크포인트

  • 이 스킬의 워크플로우를 변경하기 전에 기본 선택, 숨겨진 종속성, 안전 경계 및 Copilot 아티팩트 순서에 대한 계획을 검토합니다.
  • 편집 후 SKILL.md, 스크립트 및 참조 문서가 자체 포함된 동작, 트리거 품질, 줄 수 및 실행 가능한 검증에 대해 검토합니다.
  • 비판자는 읽기 전용으로 취급합니다. 생산자가 변경 사항을 적용하고 검증을 다시 실행합니다.

참조

필요 사항참조
상세 워크플로우references/workflow.md
종속성 및 설정references/dependencies.md
프레임 예산 및 콘택트 시트references/frame-budget.md
선택적 Scout/Whisper/Azure Speech 백엔드references/backends.md

Individual skills in this repo

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

관련 스킬