{"id":"8202e74a-7c6e-4527-b5eb-b3648af650f0","shortId":"hwA4gv","kind":"skill","title":"video-breakdown","tagline":"A collection of open-source Agent Skills for content creation — images, audio, and video.","description":"# Video Breakdown\n\nA professional video analysis skill powered by a **dual-model architecture**: ByteDance **Seed-2.0-Mini** for rapid previews and Google **Gemini 2.5 Pro** for deep, cinematic-grade analysis. It provides quantitative quality assessments and meticulous shot-by-shot breakdowns (拉片) for content creators, editors, and filmmakers.\n\n## Core Capabilities\n\n| Capability | Description | Use Case |\n| :--- | :--- | :--- |\n| **Quality Critique** | Scores 7 technical dimensions (resolution, lighting, audio, stability, composition, pacing, overall) on a 1-10 scale with professional commentary. | Evaluate UGC quality; compare video versions; pre-publish QA. |\n| **Shot Breakdown (拉片)** | Deconstructs every shot with precise timestamps, shot type, camera movement, subject, action, and narrative function. | Analyze competitor videos; study cinematic techniques; create shot lists. |\n| **Content Strategy** | Assesses hook strength, retention curve, platform fit (TikTok/YouTube/Instagram/LinkedIn), and viral potential. | Optimize content for distribution; identify drop-off points; improve engagement. |\n\n## Model Selection\n\nThis skill uses two models, selectable via the `model` parameter:\n\n| Model | ID | Best For |\n| :--- | :--- | :--- |\n| `quick` | `bytedance-seed/seed-2.0-mini` | Fast previews, cost-sensitive tasks, initial screening |\n| `full` (default) | `google/gemini-2.5-pro` | Deep analysis, precise timestamps, cinematic-grade breakdowns |\n\n## How It Works\n\nThe skill calls a hosted proxy service that routes requests to OpenRouter, which dispatches to the selected model. The response is synchronous — the full analysis result is returned directly in the API response.\n\n### Workflow\n\n1. **Agent**: Calls `POST /api/analyze` with `video_url`, `analysis_type`, and optionally `model`.\n2. **Proxy**: Forwards the request to OpenRouter with the selected model.\n3. **Model**: Analyzes the video and returns structured JSON.\n4. **Agent**: Presents the parsed result to the user.\n\n## Usage\n\n### 1. Quick Quality Assessment (Seed-2.0-Mini)\n\n**Goal**: Get a fast quality report for a video.\n\n**Agent Action**:\n\n```json\n{\n  \"tool\": \"video-breakdown.analyze\",\n  \"args\": {\n    \"video_url\": \"https://example.com/my-video.mp4\",\n    \"analysis_type\": \"quality_critique\",\n    \"model\": \"quick\"\n  }\n}\n```\n\n### 2. Deep Shot-by-Shot Analysis (Gemini 2.5 Pro)\n\n**Goal**: Get a professional, frame-accurate shot breakdown.\n\n**Agent Action**:\n\n```json\n{\n  \"tool\": \"video-breakdown.analyze\",\n  \"args\": {\n    \"video_url\": \"https://example.com/scene.mp4\",\n    \"analysis_type\": \"shot_breakdown\",\n    \"model\": \"full\"\n  }\n}\n```\n\n**Expected Output**:\n\n```json\n[\n  {\n    \"shot_number\": 1,\n    \"start_time\": \"00:00\",\n    \"end_time\": \"00:04\",\n    \"duration_seconds\": 4,\n    \"shot_type\": \"Medium Shot\",\n    \"camera_movement\": \"Static\",\n    \"subject\": \"Young woman walking toward camera\",\n    \"action\": \"Subject walks confidently, making direct eye contact\",\n    \"narrative_function\": \"Establishes protagonist and sets confident tone\",\n    \"audio_notes\": \"Upbeat music begins, no dialogue\"\n  }\n]\n```\n\n### 3. Content Strategy Analysis\n\n**Goal**: Evaluate a video's social media performance potential.\n\n**Agent Action**:\n\n```json\n{\n  \"tool\": \"video-breakdown.analyze\",\n  \"args\": {\n    \"video_url\": \"https://example.com/reel.mp4\",\n    \"analysis_type\": \"content_strategy\",\n    \"model\": \"full\"\n  }\n}\n```\n\n## Backend Service API Reference\n\nThe proxy service is deployed on Vercel Pro (300s timeout).\n\n### `POST /api/analyze`\n\nSubmits a video for analysis.\n\n**Request Body**:\n\n```json\n{\n  \"video_url\": \"string (required)\",\n  \"analysis_type\": \"quality_critique | shot_breakdown | content_strategy (required)\",\n  \"model\": \"quick | full (optional, default: full)\"\n}\n```\n\n**Response**:\n\n```json\n{\n  \"model_used\": \"google/gemini-2.5-pro\",\n  \"analysis_type\": \"shot_breakdown\",\n  \"result\": { ... }\n}\n```\n\n### `GET /api/health`\n\nReturns service status and available models.\n\n## Deployment\n\nThe proxy service requires one environment variable:\n\n```\nOPENROUTER_API_KEY=<your-openrouter-api-key>\n```\n\nDeploy to Vercel from the `proxy/` directory within this skill.","tags":["video","breakdown","media","skills","wells1137","agent-skills","agentskills","audio-generation","claude-code","claude-code-marketplace","claude-code-plugin","claude-code-skill"],"capabilities":["skill","source-wells1137","skill-video-breakdown","topic-agent-skills","topic-agentskills","topic-audio-generation","topic-claude-code","topic-claude-code-marketplace","topic-claude-code-plugin","topic-claude-code-skill","topic-claude-code-skills","topic-claude-skills","topic-content-creation","topic-image-generation","topic-openclaw"],"categories":["media-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/wells1137/media-skills/video-breakdown","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add wells1137/media-skills","source_repo":"https://github.com/wells1137/media-skills","install_from":"skills.sh"}},"qualityScore":"0.462","qualityRationale":"deterministic score 0.46 from registry signals: · indexed on github topic:agent-skills · 24 github stars · SKILL.md body (4,137 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-01T07:01:41.741Z","embedding":null,"createdAt":"2026-04-18T22:23:53.414Z","updatedAt":"2026-05-01T07:01:41.741Z","lastSeenAt":"2026-05-01T07:01:41.741Z","tsv":"'-10':92 '-2.0':35,283 '/api/analyze':239,445 '/api/health':484 '/my-video.mp4':304 '/reel.mp4':423 '/scene.mp4':340 '/seed-2.0-mini':178 '00':355,356,359 '04':360 '1':91,235,278,352 '2':248,311 '2.5':43,319 '3':259,400 '300s':442 '4':268,363 '7':79 'accur':327 'action':121,295,331,377,414 'agent':10,236,269,294,330,413 'analysi':24,50,191,225,243,305,317,341,403,424,450,458,478 'analyz':125,261 'api':232,432,500 'architectur':32 'arg':299,335,418 'assess':55,136,281 'audio':16,84,393 'avail':489 'backend':430 'begin':397 'best':172 'bodi':452 'breakdown':3,20,62,108,197,329,344,463,481 'byted':33,176 'bytedance-se':175 'call':203,237 'camera':118,368,376 'capabl':71,72 'case':75 'cinemat':48,129,195 'cinematic-grad':47,194 'collect':5 'commentari':96 'compar':100 'competitor':126 'composit':86 'confid':380,391 'contact':384 'content':13,65,134,148,401,426,464 'core':70 'cost':182 'cost-sensit':181 'creat':131 'creation':14 'creator':66 'critiqu':77,308,461 'curv':140 'deconstruct':110 'deep':46,190,312 'default':188,471 'deploy':438,491,502 'descript':73 'dialogu':399 'dimens':81 'direct':229,382 'directori':508 'dispatch':214 'distribut':150 'drop':153 'drop-off':152 'dual':30 'dual-model':29 'durat':361 'editor':67 'end':357 'engag':157 'environ':497 'establish':387 'evalu':97,405 'everi':111 'example.com':303,339,422 'example.com/my-video.mp4':302 'example.com/reel.mp4':421 'example.com/scene.mp4':338 'expect':347 'eye':383 'fast':179,288 'filmmak':69 'fit':142 'forward':250 'frame':326 'frame-accur':325 'full':187,224,346,429,469,472 'function':124,386 'gemini':42,318 'get':286,322,483 'goal':285,321,404 'googl':41 'google/gemini-2.5-pro':189,477 'grade':49,196 'hook':137 'host':205 'id':171 'identifi':151 'imag':15 'improv':156 'initi':185 'json':267,296,332,349,415,453,474 'key':501 'light':83 'list':133 'make':381 'media':410 'medium':366 'meticul':57 'mini':36,284 'model':31,158,164,168,170,218,247,258,260,309,345,428,467,475,490 'movement':119,369 'music':396 'narrat':123,385 'note':394 'number':351 'one':496 'open':8 'open-sourc':7 'openrout':212,254,499 'optim':147 'option':246,470 'output':348 'overal':88 'pace':87 'paramet':169 'pars':272 'perform':411 'platform':141 'point':155 'post':238,444 'potenti':146,412 'power':26 'pre':104 'pre-publish':103 'precis':114,192 'present':270 'preview':39,180 'pro':44,320,441 'profession':22,95,324 'protagonist':388 'provid':52 'proxi':206,249,435,493,507 'publish':105 'qa':106 'qualiti':54,76,99,280,289,307,460 'quantit':53 'quick':174,279,310,468 'rapid':38 'refer':433 'report':290 'request':210,252,451 'requir':457,466,495 'resolut':82 'respons':220,233,473 'result':226,273,482 'retent':139 'return':228,265,485 'rout':209 'scale':93 'score':78 'screen':186 'second':362 'seed':34,177,282 'select':159,165,217,257 'sensit':183 'servic':207,431,436,486,494 'set':390 'shot':59,61,107,112,116,132,314,316,328,343,350,364,367,462,480 'shot-by-shot':58,313 'skill':11,25,161,202,511 'skill-video-breakdown' 'social':409 'sourc':9 'source-wells1137' 'stabil':85 'start':353 'static':370 'status':487 'strategi':135,402,427,465 'strength':138 'string':456 'structur':266 'studi':128 'subject':120,371,378 'submit':446 'synchron':222 'task':184 'technic':80 'techniqu':130 'tiktok/youtube/instagram/linkedin':143 'time':354,358 'timeout':443 'timestamp':115,193 'tone':392 'tool':297,333,416 'topic-agent-skills' 'topic-agentskills' 'topic-audio-generation' 'topic-claude-code' 'topic-claude-code-marketplace' 'topic-claude-code-plugin' 'topic-claude-code-skill' 'topic-claude-code-skills' 'topic-claude-skills' 'topic-content-creation' 'topic-image-generation' 'topic-openclaw' 'toward':375 'two':163 'type':117,244,306,342,365,425,459,479 'ugc':98 'upbeat':395 'url':242,301,337,420,455 'usag':277 'use':74,162,476 'user':276 'variabl':498 'vercel':440,504 'version':102 'via':166 'video':2,18,19,23,101,127,241,263,293,300,336,407,419,448,454 'video-breakdown':1 'video-breakdown.analyze':298,334,417 'viral':145 'walk':374,379 'within':509 'woman':373 'work':200 'workflow':234 'young':372 '拉片':63,109","prices":[{"id":"7f46c256-5bcb-46e6-875b-484aa50f2956","listingId":"8202e74a-7c6e-4527-b5eb-b3648af650f0","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"wells1137","category":"media-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T22:23:53.414Z"}],"sources":[{"listingId":"8202e74a-7c6e-4527-b5eb-b3648af650f0","source":"github","sourceId":"wells1137/media-skills/video-breakdown","sourceUrl":"https://github.com/wells1137/media-skills/tree/main/skills/video-breakdown","isPrimary":false,"firstSeenAt":"2026-04-18T22:23:53.414Z","lastSeenAt":"2026-05-01T07:01:41.741Z"}],"details":{"listingId":"8202e74a-7c6e-4527-b5eb-b3648af650f0","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"wells1137","slug":"video-breakdown","github":{"repo":"wells1137/media-skills","stars":24,"topics":["agent-skills","agentskills","audio-generation","claude-code","claude-code-marketplace","claude-code-plugin","claude-code-skill","claude-code-skills","claude-skills","content-creation","image-generation","openclaw","skill-md","skillsmp"],"license":null,"html_url":"https://github.com/wells1137/media-skills","pushed_at":"2026-03-04T08:32:42Z","description":"A collection of open-source Agent Skills for content creation — images, audio, and video.","skill_md_sha":"72f124926ccaeee3eed959ab09bad3ef27bf314e","skill_md_path":"skills/video-breakdown/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/wells1137/media-skills/tree/main/skills/video-breakdown"},"layout":"multi","source":"github","category":"media-skills","frontmatter":{"name":"video-breakdown"},"skills_sh_url":"https://skills.sh/wells1137/media-skills/video-breakdown"},"updatedAt":"2026-05-01T07:01:41.741Z"}}