Agent skill

Resolve Media Analysis

by samuelgursky in samuelgursky/davinci-resolve-mcp

Media intelligence layer for the DaVinci Resolve MCP. An agent skill from samuelgursky/davinci-resolve-mcp.

MITAuto-check passedMedia & Creative

Install Resolve Media Analysis

skills CLI
$ npx skills add samuelgursky/davinci-resolve-mcp --skill resolve-media-analysis -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install samuelgursky/davinci-resolve-mcp resolve-media-analysis --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/samuelgursky/davinci-resolve-mcp.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/resolve-media-analysis .claude/skills/resolve-media-analysis && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
resolve-media-analysis
GitHub stars
3.4k
Token cost
~1.1k tokens
SKILL.md length
525 words
Files
1
Skills in repo
14
Repo updated
First seen
Licence
MIT

At a glance

Media intelligence layer for the DaVinci Resolve MCP. An agent skill from samuelgursky/davinci-resolve-mcp.

  • Works in 3 steps: From media pool clips: media_pool_item… → From timeline items: timeline_item ->… → From media storage: media_storage ->…
  • Tasks that involve MCP servers
  • SKILL.md covers The First Rule, What this build cannot do…, MCP Integration and Deliverables from a transcript, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Resolve Media Analysis is an agent skill from samuelgursky/davinci-resolve-mcp. Media intelligence layer for the DaVinci Resolve MCP. Uses FFprobe, FFmpeg, and optionally Whisper to READ and ANALYZE source media — never modify, transcode, convert, or create derivatives. Provides the MCP with full context of what footage actually is so it can take informed actions within Resolve.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Media & Creative, covering MCP servers, Speech recognition and synthesis and Video production. It works with FFmpeg and Model Context Protocol. The repository describes itself as: MCP server integration for DaVinci Resolve Studio. The licence is MIT.

When your agent uses it

  • Tasks that involve MCP servers
  • Tasks that involve Speech recognition and synthesis
  • Tasks that involve Video production

Example prompts

  • “/resolve-media-analysis”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. From media pool clips: media_pool_item -> get_clip_property(clip_id) returns "File Path"
  2. From timeline items: timeline_item -> get_media_pool_item(item_id) -> then get clip properties
  3. From media storage: media_storage -> get_files(path) lists files in a directory

What it can do on your machine

Read from SKILL.md and the folder at commit 94c7a88. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Resolve Media Analysis loads about 1.1k tokens when it runs. Until then it costs about 81 tokens; SKILL.md has 525 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~81
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from samuelgursky/davinci-resolve-mcp at commit 94c7a88, republished under its MIT licence (© samuelgursky). 525 words, ~1,115 tokens.

Download SKILL.mdSave it as .claude/skills/resolve-media-analysis/SKILL.md (or your agent's skills folder).
name
resolve-media-analysis
description
Media intelligence layer for the DaVinci Resolve MCP. Uses FFprobe, FFmpeg, and optionally Whisper to READ and ANALYZE source media — never modify, transcode, convert, or create derivatives. Provides the MCP with full context of what footage actually is so it can take informed actions within Resolve.

Resolve Media Analysis

This skill wraps the project's canonical media analysis guide with Claude Code-specific integration.

Read docs/guides/media-analysis-guide.md for the complete guide. Everything below is Claude Code-specific context.

The First Rule

Never touch the source. Your relationship to source media is READ-ONLY. See docs/guides/media-analysis-guide.md section "The First Rule: Never Touch the Source" for the full rationale from every post-production department.

What this build cannot do (check before you offer it)

The scripting API changes per patch release, so "Resolve 21" is not a usable label. Read resolve_control get_version → build.unavailable_on_this_build before offering a gated surface; check_version_support asks about one named symbol. Gated in this domain — note all of it is Resolve's own analysis, not this repo's:

SurfaceNeedsIf absent
MediaPoolItem / Folder.AnalyzeForIntellisearch21.0No IntelliSearch index
Project.ResetIntellisearchAnalysis21.0The index cannot be cleared from a script
MediaPoolItem / Folder.AnalyzeForSlate21.0No automatic slate detection
MediaPoolItem / Folder.PerformAudioClassification / ClearAudioClassification21.0No Resolve-side audio classification
MediaPoolItem / Folder.RemoveMotionBlur21.0Unavailable
Project.GenerateSpeech21.0No AI speech generation

This repo's own analysis stack does not depend on any of them. analyze_media reads frames and audio off disk and runs its own vision/transcription/embedding tiers, so an older Resolve loses Resolve's AI features, not this pipeline. Say which one the user is actually missing.

An empty unavailable_on_this_build means nothing recorded is missing, not that everything exists — most of the API has never been version-bisected. A symbol with no gate returns unknown, which means probe it. Probe with name in dir(obj), never bare hasattr: on a Resolve object hasattr returns True for every name, real or invented, so it can only say yes.

MCP Integration

When using the DaVinci Resolve MCP tools alongside media analysis:

Getting File Paths from Resolve
  1. From media pool clips: media_pool_item -> get_clip_property(clip_id) returns "File Path"
  2. From timeline items: timeline_item -> get_media_pool_item(item_id) -> then get clip properties
  3. From media storage: media_storage -> get_files(path) lists files in a directory
Show full SKILL.md (215 more words)Show less
Workflow: Analyze Before Acting
  1. Identify the media — Use MCP to get clip IDs and file paths
  2. Check for existing analysis — Look for sidecar JSON files
  3. Analyze if needed — Run FFprobe (+ optional tools) on the files
  4. Act with context — Use MCP tools with full knowledge of what the media is

Analysis informs Resolve actions. At no point do we create intermediate files that enter the media pipeline.

Deliverables from a transcript

  • generate_captions(clip_ref, format='srt'|'vtt', with_chapters=?) — caption blocks under broadcast rules: line-length and lines-per-block caps, max and min block duration, breaks at sentence ends then pauses then clauses, timings snapped to spoken words, a minimum inter-block gap, no single-word orphan. Never drops a word to make text fit — it refuses instead.
  • assess_grade — numeric grade-damage QC on a decoded frame. See the color-grade skill; it is exposed here because it lives beside the other frame analysis. image_qc_capabilities reports numpy/ffmpeg availability and the cost tiers.

Setup

On first use, ask the user the three setup questions documented in the guide:

  1. Where to save analysis files (alongside / directory / project)
  2. Tool detection (FFprobe required, FFmpeg/Whisper optional)
  3. Analysis depth (quick / standard / deep)

Full Reference

All analysis commands, output format, examples, proactive warnings, and principles are in docs/guides/media-analysis-guide.md. Do not duplicate that content — read and follow it.

© samuelgursky, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/resolve-media-analysis of samuelgursky/davinci-resolve-mcp.

Open the folder on GitHubat commit 94c7a88

Compare with similar skills

Resolve Media Analysis next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Resolve Media Analysis compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Resolve Media Analysis this skillsamuelgursky/davinci-resolve-mcp3.4k—~1.1kAutomated safety check: PassMIT
OpenStoryline Install HelperFireRedTeam/FireRed-OpenStoryline3.5k—~1.5kAutomated safety check: NotesApache-2.0
Cassette Video EditCassette-Editor/oh-my-cassette1191 repos~3.4kAutomated safety check: PassMIT
KinocutKyaniteLabs/kinocut198—~5.7kAutomated safety check: PassApache-2.0
Kinocut RepurposeKyaniteLabs/kinocut198—~1kAutomated safety check: PassApache-2.0
Blender MCP Videomicky-li-hd/VideoCoCo118—~1.1kAutomated safety check: PassNone

Similar skills

  • OpenStoryline Install Helper

    FireRedTeam/FireRed-OpenStoryline

    Installs, repairs and starts a local source checkout of FireRed-OpenStoryline, from prerequisites and a venv to resources, config and the MCP and web servers.

    3.5k GitHub stars~1.5k tokensUpdated 2 mo ago
    Media & CreativeAuto-check: notes
  • Cassette Video Edit

    Cassette-Editor/oh-my-cassette

    Edit, trim, cut, caption, subtitle, reframe, combine, add background music to, or export video, audio, and image files through Cassette.

    119 GitHub starsUsed in 1 repo~3.4k tokens
    Media & CreativeAuto-check passed
  • Kinocut

    KyaniteLabs/kinocut

    Use Kinocut for guarded video editing, source-backed planning, FFmpeg operations, media analysis, subtitles, audio workflows, Hyperframes or Revideo rendering, repurposing packages, and release…

    198 GitHub stars~5.7k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Kinocut Repurpose

    KyaniteLabs/kinocut

    Use the current Kinocut tools to turn one local video path into a short platform-ready clip package with manifests, review artifacts, and human approval gates.

    198 GitHub stars~1k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Blender MCP Video

    micky-li-hd/VideoCoCo

    A skill your agent uses for Blender MCP or Blender CLI video-generation work, especially when rendering scripted Blender scenes, debugging MCP port 9876, checking why blender is not on PATH…

    118 GitHub stars~1.1k tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed
  • Cassette Model

    Cassette-Editor/oh-my-cassette

    Show or change the Cassette editing model and thinking level for the current media session.

    119 GitHub starsUsed in 1 repo~374 tokens
    Media & CreativeAuto-check passed

More from samuelgursky/davinci-resolve-mcp

All 14 skills in this repo
  • Resolve MCP

    samuelgursky/davinci-resolve-mcp

    Orientation and index for DaVinci Resolve MCP work — grading, editing, conforming, delivery, media analysis, and .drp/.drt/.drx file work, live in a running Resolve or offline with none open.

    3.4k GitHub stars~1.5k tokensUpdated yesterday
    Auto-check passed
  • Resolve Rough Cut

    samuelgursky/davinci-resolve-mcp

    Assembling a short-form social rough cut from raw behind-the-scenes or vlog footage in the DaVinci Resolve MCP.

    3.4k GitHub stars~2.9k tokensUpdated yesterday
    Auto-check passed
  • House Style

    samuelgursky/davinci-resolve-mcp

    The editorial and finishing preferences this project's work is judged against — cut rhythm, shot selection, delivery conventions, and the corrections that have already been given.

    3.4k GitHub stars~736 tokensUpdated yesterday
    Auto-check passed
  • Resolve Audio

    samuelgursky/davinci-resolve-mcp

    Audio and Fairlight work in the DaVinci Resolve MCP. An agent skill from samuelgursky/davinci-resolve-mcp.

    3.4k GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Resolve Color

    samuelgursky/davinci-resolve-mcp

    Color grading and look work in the DaVinci Resolve MCP. An agent skill from samuelgursky/davinci-resolve-mcp.

    3.4k GitHub stars~1.9k tokensUpdated yesterday
    Auto-check passed
  • Resolve Conform

    samuelgursky/davinci-resolve-mcp

    Conforming, relinking, and finishing prep in the DaVinci Resolve MCP.

    3.4k GitHub stars~2.1k tokensUpdated yesterday
    Auto-check passed

Questions about Resolve Media Analysis

What does Resolve Media Analysis do?

Media intelligence layer for the DaVinci Resolve MCP. An agent skill from samuelgursky/davinci-resolve-mcp. Resolve Media Analysis is an agent skill from samuelgursky/davinci-resolve-mcp. Media intelligence layer for the DaVinci Resolve MCP.

When should I use Resolve Media Analysis?

Resolve Media Analysis fits situations like: tasks that involve MCP servers; tasks that involve Speech recognition and synthesis; tasks that involve Video production.

How do I install Resolve Media Analysis in Claude Code?

Run `npx skills add samuelgursky/davinci-resolve-mcp --skill resolve-media-analysis -a claude-code`. Or copy the skill folder (.agents/skills/resolve-media-analysis in samuelgursky/davinci-resolve-mcp) into .claude/skills/resolve-media-analysis in your project. Claude Code loads it when a task matches its description.

How do I install Resolve Media Analysis in Codex?

Run `npx skills add samuelgursky/davinci-resolve-mcp --skill resolve-media-analysis -a codex`. Or copy the skill folder (.agents/skills/resolve-media-analysis in samuelgursky/davinci-resolve-mcp) into .agents/skills/resolve-media-analysis in your project. Codex loads it when a task matches its description.

Can I use Resolve Media Analysis in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add samuelgursky/davinci-resolve-mcp --skill resolve-media-analysis -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/resolve-media-analysis, .gemini/skills/resolve-media-analysis, .github/skills/resolve-media-analysis and .opencode/skills/resolve-media-analysis in your project.

What does Resolve Media Analysis need to run?

SKILL.md names no scripts, command-line tools or credentials: Resolve Media Analysis is instructions for the agent only.

Does Resolve Media Analysis access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Resolve Media Analysis safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Resolve Media Analysis use?

Resolve Media Analysis is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Resolve Media Analysis use?

About 1.1k tokens (SKILL.md is roughly 4.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Resolve Media Analysis?

Skills that share tags, products or a category with Resolve Media Analysis: OpenStoryline Install Helper (FireRedTeam/FireRed-OpenStoryline, 3.5k stars), Cassette Video Edit (Cassette-Editor/oh-my-cassette, 119 stars), Kinocut (KyaniteLabs/kinocut, 198 stars) and Kinocut Repurpose (KyaniteLabs/kinocut, 198 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Resolve Media Analysis?

samuelgursky (a GitHub user) maintains it in samuelgursky/davinci-resolve-mcp, which has 3,448 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on October 9, 2026.

Source: samuelgursky/davinci-resolve-mcp on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.