video-viewing Skill: Скачивание и анализ видео

--- name: video-viewing description: Download, view, and analyze video files from direct URLs. Use this skill when the user asks to download, save, view, or analyze video files from direct links (mp4, webm, mkv, avi, mov files). Does NOT support YouTube or other streaming platforms - only direct video file URLs. --- # Video Viewing and Analysis Download and analyze video files from direct URLs with frame extraction and metadata retrieval. ## Quick Start The simplest way to download a video: ```bash python scripts/download_video.py "https://example.com/video.mp4" ``` This downloads the video to `/mnt/user-data/outputs/` (or current directory if not available). ## Options ### Custom Output Directory Use `-o` or `--output` to specify a different output directory: ```bash python scripts/download_video.py "URL" -o /path/to/directory ``` ### Custom Filename Use `-n` or `--name` to specify a custom filename (without extension): ```bash python scripts/download_video.py "URL" -n my_video ``` ### Extract Frames Use `-f` or `--frames` to extract key frames from the video: ```bash python scripts/download_video.py "URL" -f ``` This extracts frames at regular intervals and saves them as images for visual analysis. ### Get Video Info Use `-i` or `--info` to get video metadata without downloading: ```bash python scripts/download_video.py "URL" -i ``` This displays duration, resolution, codec, frame rate, and file size. ## Complete Examples 1. Download video with default settings: ```bash python scripts/download_video.py "https://previews.customer.envatousercontent.com/h264-video-previews/dfb637cb-f04e-46dc-99dc-256fa6090958/61509131.mp4" ``` 2. Download and extract frames for analysis: ```bash python scripts/download_video.py "https://example.com/video.mp4" -f ``` 3. Get video information only: ```bash python scripts/download_video.py "https://example.com/video.mp4" -i ``` 4. Download to custom directory with custom name: ```bash python scripts/download_video.py "https://example.com/video.mp4" -o /custom/path -n my_video ``` ## How It Works The skill uses standard Python libraries to: - Download video files using `requests` with streaming support - Extract video metadata using `ffprobe` (part of ffmpeg) - Extract key frames using `ffmpeg` - Support resume for partially downloaded files ## Viewing Downloaded Videos After downloading, Claude can analyze the video content by: 1. Extracting frames at key intervals 2. Analyzing the extracted images to describe video content 3. Providing metadata about duration, resolution, and format ## Requirements The script requires: - Python 3.7+ - `requests` library (installed automatically) - `ffmpeg` and `ffprobe` for frame extraction and metadata (optional) Install ffmpeg on Ubuntu/Debian: ```bash sudo apt-get install ffmpeg ``` Install ffmpeg on macOS: ```bash brew install ffmpeg ``` ## Important Notes - Only supports direct video file URLs (not streaming platforms like YouTube) - Supported formats: mp4, webm, mkv, avi, mov, m4v, wmv, flv - Large files are downloaded with progress indication - Frame extraction requires ffmpeg to be installed - Downloads are saved to `/mnt/user-data/outputs/` by default, or current directory