Use this skill when setting up or migrating GitHub Actions workflows to Depot-managed runners.
What It Owns
choosing runner labels and sizes
replacing runs-on values in workflows
ARM, Windows, and macOS runner choices
troubleshooting common Depot runner setup problems
Core Rules
Use a single Depot runner label per job.
Treat it as a drop-in runner change first; avoid unnecessary workflow rewrites.
Confirm org/app installation and runner permissions before debugging job logic.
Be explicit about OS, architecture, and size tradeoffs.
Typical Workflow
Confirm the repo is connected to Depot runners.
Pick the smallest runner that safely fits the workload.
Update runs-on to the Depot label.
Re-run the workflow and debug any environment-specific breakage.
Important Caveats
Windows runners do not support Docker.
macOS capacity may queue instead of scaling elastically.
ARM migrations can expose architecture assumptions in toolchains or images.
1---2name: depot-github-runners3description: Configure Depot-managed GitHub Actions runners as a drop-in replacement for GitHub-hosted runners.4---56# Depot GitHub Runners78Use this skill when setting up or migrating GitHub Actions workflows to Depot-managed runners.910## What It Owns1112- choosing runner labels and sizes13- replacing `runs-on` values in workflows14- ARM, Windows, and macOS runner choices15- troubleshooting common Depot runner setup problems1617## Core Rules1819- Use a single Depot runner label per job.20- Treat it as a drop-in runner change first; avoid unnecessary workflow rewrites.21- Confirm org/app installation and runner permissions before debugging job logic.22- Be explicit about OS, architecture, and size tradeoffs.2324## Typical Workflow25261. Confirm the repo is connected to Depot runners.272. Pick the smallest runner that safely fits the workload.283. Update `runs-on` to the Depot label.294. Re-run the workflow and debug any environment-specific breakage.3031## Important Caveats3233- Windows runners do not support Docker.34- macOS capacity may queue instead of scaling elastically.35- ARM migrations can expose architecture assumptions in toolchains or images.
Run npx get-skill add ajoslin/depot-github-runners in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Configure Depot-managed GitHub Actions runners as a drop-in replacement for GitHub-hosted runners. It is listed under Coding & Dev Tools on SkillMD.
SkillMD's automated safety review verdict for this skill is PASS. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
ajoslin (@ajoslin) published this skill. Their other Agent Skills are listed on their SkillMD profile.