depot-github-runners

Configures Depot-managed GitHub Actions runners as a drop-in replacement for GitHub-hosted runners. Use when setting up or migrating GitHub Actions workflows to use Depot runners, choosing runner sizes (CPU/RAM), configuring runs-on labels, setting up ARM or Windows or macOS runners, troubleshooting GitHub Actions runner issues, configuring egress filtering, using Depot Cache with GitHub Actions, or running Dagger/Dependabot on Depot runners. Also use when the user mentions depot-ubuntu, depot-windows, depot-macos runner labels, or asks about faster/cheaper GitHub Actions runners.

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

82%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A dense, highly actionable reference with concrete labels, commands, YAML, and a troubleshooting matrix. It is well-structured and lean, with only minor room to tighten verbose sections and add explicit verification checkpoints to its setup workflows.

Suggestions

Add a verification step to the Setup and Tailscale workflows (e.g. run a test job or confirm the runner appears in the dashboard) so each sequence has an explicit checkpoint.

Consider moving the full per-size pricing/label tables and the Tailscale ACL JSON examples into a reference file, keeping SKILL.md as a lean overview that links to the details.

Trim the troubleshooting table to the highest-frequency errors or move the long tail into a reference, to reduce token weight while preserving the most useful fixes inline.

Dimension	Reasoning	Score
Conciseness	Mostly lean and reference-dense — pricing/label tables and command snippets assume Claude's competence — but the two full ACL JSON blocks and the exhaustive troubleshooting table carry minor padding that could be trimmed without losing clarity.	4 / 5
Actionability	Provides copy-paste-ready YAML (migration before/after, common-mistakes wrong/correct), concrete CLI commands ('depot org show/list/switch'), exact runner labels with CPU/RAM/price, and a troubleshooting table mapping errors to specific fixes — covering the common cases fully.	5 / 5
Workflow Clarity	Setup and Tailscale onboarding are clearly numbered and sequenced, and the troubleshooting table supplies error-recovery feedback, but neither workflow includes an explicit verification checkpoint (e.g. confirming the runner connected or the label took effect), leaving a minor validation gap.	4 / 5
Progressive Disclosure	Well-organized into clearly headed sections (Setup, Runner Labels, Caching, Tailscale, Dependabot, Troubleshooting) with no nested references, but the full label/pricing tables and ACL examples are entirely inlined in a >50-line file rather than offloaded to reference files, leaving minor organization headroom.	4 / 5
	Total	17 / 20 Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, third-person description that concretely enumerates capabilities, provides explicit 'Use when' triggers with natural synonyms and product-specific labels, and is clearly distinguishable from generic CI skills.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'setting up or migrating GitHub Actions workflows', 'choosing runner sizes (CPU/RAM)', 'configuring runs-on labels', 'setting up ARM or Windows or macOS runners', 'configuring egress filtering', 'using Depot Cache', 'running Dagger/Dependabot' — giving comprehensive coverage of the skill's capabilities.	5 / 5
Completeness	Explicitly answers both 'what' ('Configures Depot-managed GitHub Actions runners as a drop-in replacement for GitHub-hosted runners') and 'when' via two 'Use when...'/'Also use when...' clauses with concrete trigger phrases.	5 / 5
Trigger Term Quality	Covers natural user phrasing including synonyms and concrete labels: 'faster/cheaper GitHub Actions runners', 'depot-ubuntu, depot-windows, depot-macos runner labels', plus 'troubleshooting GitHub Actions runner issues'. These match what a user would actually say.	5 / 5
Distinctiveness Conflict Risk	Occupies a clear niche (Depot-managed runners) with distinct, proprietary trigger labels (depot-ubuntu, depot-windows, depot-macos) that are unlikely to fire for unrelated skills.	5 / 5
	Total	20 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: PostHog/posthog
Path: .agents/skills/depot-github-runners/SKILL.md
Commit: 6fca5f8

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.