Move Docker builds to Depot
Ask your agent to adapt an existing Docker build or Bake configuration for Depot, including multi-platform images, caching and where the resulting images are stored.
Overview
Depot Skills gives AI coding agents instructions for working with Depot from the shell, including generating CLI commands and configuring builds, runners and workflows. It helps when you want an agent to work with your Depot infrastructure using product-specific guidance. The agent can select relevant skills as you work, though automatic selection varies by agent. If it overlooks them, add “using the Depot skills” to your prompt. Running Depot operations requires the account access and setup for the service you use.
Use Cases
Change GitHub Actions runner infrastructure
Have your agent choose Depot runner labels and sizes and update workflow configuration. Connecting the GitHub organization requires an organization owner and the Depot GitHub App; public repositories also need runner-group permission.
Debug CI before pushing changes
Use the Depot CI skill to help an agent run workflows against your local working tree, inspect failures and rerun after a fix, without first committing or pushing changes.
Migrate workflows to Depot CI
Ask your agent to check GitHub Actions compatibility and help migrate workflows, secrets and variables. Migration leaves the original GitHub workflows in place, so deployments and other side effects can run twice while both systems are active.
Set up Depot access
Get agent guidance on CLI authentication, project configuration and organization selection, including choosing token or OIDC authentication for automation.
Components
Skills
This plugin's skills 4Account or credentials needed
depot-container-builds
Guides Docker build migration, multi-platform images, caching and registry output.
depot-github-runners
Helps configure managed GitHub Actions runners, sizes, caching and network access.
depot-ci
Guides workflow migration, secrets, local-change runs and CI failure investigation.
depot-general
Covers CLI setup, authentication, projects, organizations and Depot API access.
Install
Install Depot Skills using the method for your AI tool. To run Depot operations afterward, you will also need the relevant Depot account access and service setup; see the CLI installation and authentication guide.
Claude Code
- 01
From your project folder, run this command in your terminal to install Depot Skills for Claude Code in that project. To make the skills available in every project, add
-gto the command. The installer detects supported agents and places the skill files for them.npx skills add depot/skills - 02
Ask Claude Code which Depot skills it has available. If it overlooks them during a task, add “using the Depot skills” to your prompt.
- 03
From your project folder, run this command in your terminal to install Depot Skills for Cursor in that project. To make the skills available in every project, add
-gto the command. The installer detects supported agents and places the skill files for them.npx skills add depot/skills - 04
Ask the agent in Cursor which Depot skills it has available. If it overlooks them during a task, add “using the Depot skills” to your prompt.
- 03
In Cursor chat, run this command to open the plugin installer.
/add-plugin - 04
Search for Depot Skills, or enter
depot/skills, and install the plugin. - 05
Ask the agent in Cursor which Depot skills it has available. If it overlooks them during a task, add “using the Depot skills” to your prompt.
Use the repository's manual fallback to add the Depot instructions as rules for one Cursor workspace.
- 03
Create
.cursor/rules/in your project if it does not exist. Copy each linked skill file into that folder under the filename shown.- Container Builds SKILL.md →
depot-container-builds.mdc - GitHub Actions Runners SKILL.md →
depot-github-runners.mdc - Depot CI SKILL.md →
depot-ci.mdc - General SKILL.md →
depot-general.mdc
- Container Builds SKILL.md →
- 04
Open Cursor Settings → Rules and verify that these files are enabled for the workspace.
- 03
From your project folder, run this command in your terminal to install Depot Skills for Codex in that project. To make the skills available in every project, add
-gto the command. The installer detects supported agents and places the skill files for them.npx skills add depot/skills - 04
Ask Codex which Depot skills it has available. If it overlooks them during a task, add “using the Depot skills” to your prompt.