--- name: qwen-vision description: > Use when the user asks to "analyze video", "watch this video", "what happens in this video", "describe this clip", "review this footage", "classify these videos", "compare videos", "analyze this image", "what's in this screenshot", or when the user provides a video/image file path and expects visual understanding. Also trigger on: "qwen", "video bridge", "multimodal analysis", "motion analysis", "video reference", "video breakdown", "batch classify", or any task requiring understanding of video content that Claude cannot do natively. version: 0.1.0 --- # Qwen Vision Bridge Claude cannot natively understand video. This skill bridges that gap by calling Qwen Omni — a natively multimodal model that processes video with temporal attention (it sees motion, not just individual frames). The bridge also handles images, useful when you want Qwen's analysis on screenshots, diagrams, or photos. ## How it works A Python script at `${CLAUDE_PLUGIN_ROOT}/skills/qwen-vision/scripts/qwen_bridge.py` sends media files to the Qwen API and returns the analysis as text. Call it via Bash. ## Prerequisites The user must have: 1. `DASHSCOPE_API_KEY` environment variable set (get one at https://dashscope.console.aliyun.com/ or https://modelstudio.console.alibabacloud.com/) 2. Python 3.9+ with `dashscope` package installed If the user hasn't set up yet, suggest running `/qwen-setup` first. ## Basic usage ```bash python3 "${CLAUDE_PLUGIN_ROOT}/skills/qwen-vision/scripts/qwen_bridge.py" "/path/to/video.mp4" "Describe what happens in this video" ``` ## Parameters | Flag | Default | Description | |------|---------|-------------| | (positional 1) | required | Path to video or image file | | (positional 2) | generic prompt | Analysis prompt | | `--fps` | 2.0 | Frames per second to sample from video. Lower = cheaper, higher = more detail | | `--model` | qwen-omni-plus-latest | Qwen model to use | | `--json` | off | Output as JSON (for parsing) | | `--context` | none | Path to JSON file with previous conversation (multi-turn) | | `--save-context` | none | Save conversation context for follow-up questions | | `--system-prompt` | none | Custom system prompt for Qwen | | `--prompt-file` | none | Read prompt from a file instead of argument | ## Supported formats **Video:** .mp4, .mov, .avi, .mkv, .webm, .flv, .wmv **Image:** .png, .jpg, .jpeg, .gif, .webp, .bmp, .tiff ## Patterns ### Single video analysis ```bash python3 "${CLAUDE_PLUGIN_ROOT}/skills/qwen-vision/scripts/qwen_bridge.py" "/path/to/video.mp4" "Describe the character's body movement, poses, and transitions" --fps 2 ``` Parse the text response and use it in your answer to the user. ### Batch analysis When the user has multiple videos to analyze, write a Python script that loops through files and calls the bridge for each one. Use `--json` flag for machine-readable output. See `references/batch-pattern.md` for a template. ### Multi-turn (follow-up questions) ```bash # First question python3 "${CLAUDE_PLUGIN_ROOT}/skills/qwen-vision/scripts/qwen_bridge.py" video.mp4 "General analysis" --save-context /tmp/ctx.json # Follow-up python3 "${CLAUDE_PLUGIN_ROOT}/skills/qwen-vision/scripts/qwen_bridge.py" video.mp4 "Tell me more about the lighting" --context /tmp/ctx.json ``` ### Image analysis Same script, just pass an image path instead of video: ```bash python3 "${CLAUDE_PLUGIN_ROOT}/skills/qwen-vision/scripts/qwen_bridge.py" "/path/to/screenshot.png" "What UI elements are visible in this screenshot?" ``` ### Cost-saving tips - Use `--fps 1` for long videos or when fine detail isn't needed - Use `--fps 0.5` for very long videos (minutes+) - For batch jobs, start with `--fps 1` and increase only if results are too vague ## Error handling - If `DASHSCOPE_API_KEY` is not set, the script exits with a clear error message. Guide the user to set it up. - If `dashscope` is not installed, suggest `pip install dashscope`. - If the API returns an error, the script prints the error code and message. Common issues: invalid key, quota exceeded, unsupported file format. - If a video file is too large for the API, suggest lowering `--fps` or trimming the video first. ## What Qwen sees vs what Claude sees This is important context for the user: Qwen processes video frames with temporal attention — it understands motion, direction, rhythm, and transitions between frames. Claude analyzing individual screenshots cannot do this. When the user needs to understand *what happens* in a video (not just what a single frame looks like), this bridge is the right tool. ## Additional resources - **`references/batch-pattern.md`** — template for batch video classification - **`references/prompt-tips.md`** — effective prompts for different analysis types --- Source attribution: davepoon Original project: https://github.com/davepoon/buildwithclaude/blob/a1103092fa571c032ae3e706433505ce0d6327bc/plugins/give-claude-eyes/skills/qwen-vision/SKILL.md License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Mega AI Hub. ## Upstream license notice MIT License Copyright (c) 2026 Kirill Brysenkov Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Mega AI Hub resource metadata Creator / publisher: davepoon Original project: https://github.com/davepoon/buildwithclaude/blob/a1103092fa571c032ae3e706433505ce0d6327bc/plugins/give-claude-eyes/skills/qwen-vision/SKILL.md Attribution basis: Source repository record Fields of work: Content & Media, Data & Analytics, Development & Engineering, Education & Research, Marketing Roles: Content Marketer, Data Scientist, ML / AI Engineer, Researcher, Video Producer Specialties: API Tools: Dashscope, Qwen Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: 0a8eda699fed3fec328409c0cc340092dff037a9a93a99a258a572d637961b91