agentleFS
ChaiWithJaiChaiWithJai/davinci-resolve-claude-skills/skills/davinci-resolve-setup/SKILL.md

davinci-resolve-setup

Skill19 starsChanged 6 months agoMITView on GitHub

Use when a user is installing DaVinci Resolve for the first time, switching machines, configuring a media drive for video editing, or asking about backup/proxy settings. Triggering symptoms include phrases like "just installed Resolve", "set up DaVinci Resolve", "drop frames during playback", "where should my media live", "how do I configure backups", or any DaVinci Resolve installation/preferences question.

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

7 rules. About 0 are common, 5 are distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈5

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    When NOT to use:

    line 20
  2. Distinctive:

    Run the installer. Restart if prompted.

    line 41
  3. Distinctive:

    Run it pointed at the drive you plan to use for media.

    line 46
  4. Distinctive:

    Look at the "Will It Work?" table.

    line 47
  5. Very specific:

    If the drive cannot sustain reads above ~500 MB/s for your codec at your resolution, you will get dropped-frame playback.

    line 48
  6. Very specific:

    Check Timeline backups too (this backs up .drt files which are smaller and recoverable independently).

    line 71
  7. Distinctive:

    If the user pushes back on a recommendation (install path, backup interval, drive speed, scripting toggle), read these PDF page ranges to …

    line 124

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

DaVinci Resolve — first-time setup for content creators

Overview

One-time configuration for DaVinci Resolve 20 so it does not bite you later. Three things matter: the install source, the media drive, and the backup settings. Everything else can be configured per-project.

When to use

Symptoms:

  • Just downloaded DaVinci Resolve and want to know what to configure first
  • Bought a new external drive and need to point Resolve at it
  • Playback drops frames or shows a red GPU indicator
  • Want to enable automatic project backups before doing real work

When NOT to use:

  • Resolve is already running fine and you have an existing project — skip to davinci-resolve-devrel-project-template.
  • You only need to enable Python scripting — that is a one-liner in Preferences > System > General (set External scripting to Local).

Quick reference

DecisionRight answerWhy
Install sourceblackmagicdesign.com, NOT Mac App StoreApp Store version sandboxes the file system
Free vs StudioFree is fine for 99% of DevRelStudio adds noise reduction, AI Smart Reframe, neural engine features
Media driveFastest external SSD you haveRead >500 MB/s minimum for 4K
Backup interval10 minutes / 24 hours / 180 daysSurvives editor crash, daily mistake, six-month regret
Render cache locationInternal SSD, not media driveReduces read/write contention

Steps

1. Install from blackmagicdesign.com (not the App Store)

  1. Open a browser, go to https://www.blackmagicdesign.com/products/davinciresolve.
  2. Click Download.
  3. Choose your OS (macOS, Windows, Linux). On macOS, do not install via the Mac App Store — it sandboxes the filesystem and breaks several workflows like the Blackmagic Proxy Generator.
  4. Run the installer. Restart if prompted.

2. Test your media drive speed before you commit to it

  1. Download Blackmagic Disk Speed Test (free, separate app). On macOS it is on the App Store. On Windows it is included with the Desktop Video installer.
  2. Run it pointed at the drive you plan to use for media.
  3. Look at the "Will It Work?" table. Confirm green checkmarks for the codecs and resolutions you actually shoot (typically H.265 at 1080p/4K, or Blackmagic RAW if you shoot on a Blackmagic camera).
  4. If the drive cannot sustain reads above ~500 MB/s for your codec at your resolution, you will get dropped-frame playback. Buy a faster drive or generate proxies (covered in davinci-resolve-devrel-project-template).

3. First launch — set the media folders

  1. Launch DaVinci Resolve. Skip the welcome screen.
  2. Click DaVinci Resolve > Preferences (macOS) or DaVinci Resolve > Preferences (Windows).
  3. Switch to the System tab at the top.
  4. Click Media Storage in the left sidebar.
  5. Click the + button and add your media drive. This tells Resolve where to look for media by default.
  6. Click Save.

4. Enable Live Save and project backups

This is the single most important step. Resolve does NOT save by default, and you will lose work.

  1. DaVinci Resolve > Preferences > User > Project Save and Load.
  2. Confirm Live Save is checked. This auto-saves on every change.
  3. Check Project backups.
  4. Set the intervals:
    • Backups every 10 minutes (6 backups per hour)
    • Hourly backups for the past 24 hours
    • Daily backups for the past 180 days (six months)
  5. Click Browse for Backup location and pick a folder on your internal SSD (not the media drive — you want backups in a different place than your media in case the media drive dies).
  6. Check Timeline backups too (this backs up .drt files which are smaller and recoverable independently).
  7. Click Save.

These intervals are loosely based on the Colorist Guide's project backup recommendations.

5. Set the working folders for the project media cache

  1. DaVinci Resolve > Project Settings (or File > Project Settings, or press Shift-9).
  2. Master Settings > scroll to Working Folders.
  3. Set:
    • Cache files location — internal SSD (fast)
    • Proxy generation location — internal SSD or media drive (your call)
    • Project media location — typically same as Cache files, on your internal SSD
  4. Save.

6. Enable external scripting (optional, but you will want it later)

  1. DaVinci Resolve > Preferences > System > General.
  2. Set External scripting using to Local.
  3. Save. Restart Resolve.

This lets you run Python scripts against Resolve from your terminal — used by davinci-resolve-cut-screen-recording and davinci-resolve-export-multi-platform.

Common mistakes

  • Installed via Mac App Store -> uninstall and reinstall from blackmagicdesign.com. The App Store version cannot reach external drives reliably and the Blackmagic Proxy Generator is missing.
  • Media drive is USB 2.0 -> you will not be able to play back even 1080p H.264 reliably. Move to USB 3 / Thunderbolt / NVMe.
  • Backup location set to the media drive -> backups die with the media drive. Use the internal SSD.
  • Live Save unchecked -> you will lose hours of work the first time Resolve crashes.

Verification

You succeeded if all of the following are true:

  1. Resolve launches without complaining about a missing license or installer signature.
  2. You can drag a video file from your media drive into the Media Pool without Resolve marking it offline.
  3. The frame-rate indicator at the top of the source viewer stays green during playback (not red).
  4. The path under DaVinci Resolve > Preferences > User > Project Save and Load > Backup location shows a folder on your internal SSD.
  5. You can find .drp files (project backups) appearing in the backup folder after 10 minutes of editing.

Transfer

Now try this: import a clip from a different drive than the one you configured. Resolve should still find it (since the file lives at an absolute path). Then disconnect that drive and reopen the project — note how Resolve flags those clips as offline and offers Relink in the Media Pool. That is the workflow you will use the first time a colleague hands you a project file without media.

Working reference

  • docs/wiki/beginners-guide.md (install, system requirements, Quick Setup)
  • docs/wiki/colorist-guide.md#front-matter--project-backups-pp-6-7 (Live Save and project backups, primary)
  • docs/wiki/editors-guide.md#lesson-6--ai-workflows-pp-323-387 (Disk Speed Test, proxies)
  • docs/wiki/master.md#reset-matrix--when-the-user-pushes-back-read-this (cross-cutting symptom map)

When the agent's work isn't matching expectations (context-rot reset)

If the user pushes back on a recommendation (install path, backup interval, drive speed, scripting toggle), read these PDF page ranges to reset:

  • DaVinci-Resolve-20_Beginners-Guide.pdf pp. xiv-xxiv (Getting Started, system requirements, download instructions)
  • DaVinci-Resolve-20-Editors-Guide.pdf pp. xii-xxiv (Getting Started — Editor's perspective on initial setup)
  • DaVinci-Resolve-20-Editors-Guide.pdf pp. 324-337 (Generating Proxy Files; Blackmagic Disk Speed Test; drive speed considerations)
  • DaVinci-Resolve-20-Colorist-Guide.pdf pp. 6-7 (Setting Up Project Backups, Live Save settings)

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.