Project References
aiskillstore/marketplace
Look up conventions, patterns, and concrete implementations from your own GitHub repositories checked out locally under ~/projects/referenzen/.
Deploy, manage, and troubleshoot self-hosted GitHub Actions runners.
Install GitHub Runner
$ npx skills add magnus919/agent-skills --skill github-runner -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install magnus919/agent-skills github-runner --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/magnus919/agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/github-runner .claude/skills/github-runner && rm -rf skills-srcUse ~/.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/
Install the "github-runner" agent skill from https://github.com/magnus919/agent-skills/tree/main/github-runner into .claude/skills/github-runner/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "github-runner", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/magnus919/agent-skills/tree/main/github-runnerType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add magnus919/agent-skills --skill github-runner -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install magnus919/agent-skills github-runner --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/magnus919/agent-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/github-runner .agents/skills/github-runner && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "github-runner" agent skill from https://github.com/magnus919/agent-skills/tree/main/github-runner into .agents/skills/github-runner/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "github-runner", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add magnus919/agent-skills --skill github-runner -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install magnus919/agent-skills github-runner --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/magnus919/agent-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/github-runner .cursor/skills/github-runner && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "github-runner" agent skill from https://github.com/magnus919/agent-skills/tree/main/github-runner into .cursor/skills/github-runner/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "github-runner", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/magnus919/agent-skills.git --path github-runner--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add magnus919/agent-skills --skill github-runner -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install magnus919/agent-skills github-runner --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/magnus919/agent-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/github-runner .gemini/skills/github-runner && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "github-runner" agent skill from https://github.com/magnus919/agent-skills/tree/main/github-runner into .gemini/skills/github-runner/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "github-runner", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install magnus919/agent-skills github-runnerInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add magnus919/agent-skills --skill github-runner -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/magnus919/agent-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/github-runner .github/skills/github-runner && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "github-runner" agent skill from https://github.com/magnus919/agent-skills/tree/main/github-runner into .github/skills/github-runner/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "github-runner", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add magnus919/agent-skills --skill github-runner -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install magnus919/agent-skills github-runner --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/magnus919/agent-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/github-runner .opencode/skills/github-runner && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "github-runner" agent skill from https://github.com/magnus919/agent-skills/tree/main/github-runner into .opencode/skills/github-runner/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "github-runner", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
github-runner- GitHub stars
- 111
- Token cost
- ~1.7k tokens
- SKILL.md length
- 652 words
- Files
- 12 (incl. references)
- Skills in repo
- 129
- Repo updated
- First seen
- Licence
- MIT
At a glance
Deploy, manage, and troubleshoot self-hosted GitHub Actions runners.
- Works in 6 steps: Choose deployment approach → Figure out what runner scope you need → Register the runner → …
- Setting up a CI runner
- SKILL.md covers When to Use, Quick Reference, Sequential Workflow and Templates, plus 1 more section
- Calls gh and docker; needs ACCESS_TOKEN and RUNNER_TOKEN
What it does
GitHub Runner is an agent skill from magnus919/agent-skills. Deploy, manage, and troubleshoot self-hosted GitHub Actions runners. Covers systemd service, Docker containers, Kubernetes (Actions Runner Controller), and the Scale Set Client. Use when setting up a CI runner, debugging registration failures, designing autoscaling, or hardening runner security. Do not use this skill for unrelated requests; route to the nearest named specialist.
Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 14 other files, including reference files (for example `README.md`, `evals/evals.json` and `references/architecture.md`). Compatibility notes: Linux, macOS, or Windows target hosts. Docker for containerized runners. Kubernetes for ARC deployments.
It sits in DevOps & Cloud, covering CI/CD, Containers and Linux administration. It works with Docker, GitHub Actions, GitHub and Kubernetes. The repository describes itself as: Curated collection of AI agent skills for Hermes and other agent frameworks. The licence is MIT.
When your agent uses it
- Setting up a CI runner
- Debugging registration failures
- Designing autoscaling
- Hardening runner security
Example prompts
- “/github-runner”
Requirements
- Docker
- A credential in ACCESS_TOKEN
- A credential in RUNNER_TOKEN
- Compatibility (from SKILL.md): Linux, macOS, or Windows target hosts. Docker for containerized runners. Kubernetes for ARC deployments.
Workflow steps
6 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit 96fbe07. 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
Shell commands in SKILL.md call:
ghdocker
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use gh and docker, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
ACCESS_TOKENRUNNER_TOKEN
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Compatibility
Linux, macOS, or Windows target hosts. Docker for containerized runners. Kubernetes for ARC deployments.
From compatibility in the SKILL.md frontmatter.
Context cost
GitHub Runner loads about 1.7k tokens when it runs, and up to ~9.8k if it reads all its reference files. Until then it costs about 99 tokens; SKILL.md has 652 words of instructions outside code blocks.
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 magnus919/agent-skills at commit 96fbe07, republished under its MIT licence (© magnus919). 652 words, ~1,744 tokens.
Download SKILL.mdSave it as
.claude/skills/github-runner/SKILL.md (or your agent's skills folder). This skill also uses 11 other files; get the full folder from GitHub.- name
- github-runner
- description
- Deploy, manage, and troubleshoot self-hosted GitHub Actions runners. Covers systemd service, Docker containers, Kubernetes (Actions Runner Controller), and the Scale Set Client. Use when setting up a CI runner, debugging registration failures, designing autoscaling, or hardening runner security. Do not use this skill for unrelated requests; route to the nearest named specialist.
- compatibility
- Linux, macOS, or Windows target hosts. Docker for containerized runners. Kubernetes for ARC deployments.
- license
- MIT
- metadata.tags
- github-actions, ci-cd, runners, devops, docker, kubernetes, autoscaling
- metadata.source
- https://docs.github.com/en/actions/hosting-your-own-runners/managing-self-hosted-runners
- metadata.version
- 1.0.2
Self-Hosted GitHub Actions Runner
Deploy and manage self-hosted GitHub Actions runners — the machines that execute CI/CD workflow jobs. Self-hosted runners give you control over hardware, OS, and toolchain, at the cost of requiring you to maintain the environment.
When to Use
| Trigger | What to do |
|---|---|
| "Set up CI for my project", "deploy a self-hosted runner for [repo/org]" | Read deployment — choose systemd, Docker, or ARC |
| "Runner won't register / keeps failing", "runner gets 404", "registration token expired" | Read management — ACCESS_TOKEN vs RUNNER_TOKEN, groups |
| "How to scale runners automatically", "auto-scale runners", "too many queued jobs" | Read scaling — ARC, Scale Set Client, ephemeral |
| "Secure my self-hosted runners", "hardening runners", "runner security", "public repo risk" | Read security — public repo risks, ephemeral, JIT, groups |
| "Make a custom runner image", "build a runner Dockerfile", "custom runner with Python" | Read custom-images — Dockerfile, ARC container modes |
| "What domains does a runner need to reach?", "runner firewall rules", "runner network setup" | Read network — firewall rules, TLS, proxy |
| "Labels, groups, or both for routing?", "how to target specific runners" | Read management — labels and groups sections |
| "Monitor / troubleshoot runner issues", "runner offline", "runner not picking up jobs" | Read management — monitoring and troubleshooting sections |
Quick Reference
Deployment Spectrum
| Approach | Complexity | Autoscaling | Best For |
|---|---|---|---|
| systemd service | Low | Manual | Single machine, simple CI |
| Docker container | Medium | Manual replicas | Homelab, small team |
| ARC (Kubernetes) | High | Built-in | Teams with K8s expertise |
| Scale Set Client | High | Custom | Non-K8s platform teams |
Critical: ACCESS_TOKEN vs RUNNER_TOKEN
This is the most common setup failure. The myoung34/github-runner Docker entrypoint unexports RUNNER_TOKEN at startup — it's only used for de-registration. Registration requires ACCESS_TOKEN (a GitHub PAT).
| Token | Purpose | Expiry |
|---|---|---|
ACCESS_TOKEN | Registration — generates fresh tokens via GitHub API | Long-lived (PAT) |
RUNNER_TOKEN | De-registration only — NOT for initial registration | 60 min |
PAT scopes:
- Repo-level:
repo - Org-level:
admin:org - Enterprise-level:
manage_runners:enterprise
Labels Strategy
Default labels: self-hosted + OS (linux/windows/macOS) + arch (x64/ARM/ARM32/ARM64)
Common convention: self-hosted,<hostname>,<os>,<arch>,<project>. In workflows:
runs-on: [self-hosted, linux, x64, gpu]All labels must match (AND logic). Use --no-default-labels to strip OS/arch auto-labels.
Key Pitfalls
| Problem | Cause | Fix |
|---|---|---|
| 404 on POST to runner-registration | RUNNER_TOKEN used instead of ACCESS_TOKEN | Switch to ACCESS_TOKEN with PAT |
| "Could not find any self-hosted runner group named 'Default'" | Org uses different group name | Check groups via gh api, set RUNNER_GROUP |
| "Ephemeral option is enabled" when not wanted | EPHEMERAL=0 — truthy in bash | Use EPHEMERAL=false (string) |
docker compose down -v wipes credentials | Named volumes deleted | With ACCESS_TOKEN, auto-recovers |
| Runner can't see host filesystem paths | Runner runs inside Docker container | Write deploy configs inline in workflow |
| Hugo build: "Go not found" | No Go on Ubuntu 20.04 runner | hugo mod vendor and commit _vendor/ |
| GHCR pull "unauthorized" | No Docker registry auth in deploy job | Add docker/login-action@v4 |
| Runner offline >14 days | Auto-removed by GitHub | Register a new runner |
Show full SKILL.md (210 more words)Show less
Sequential Workflow
1. Choose deployment approach
Read deployment and select systemd, Docker, ARC, or Scale Set Client.
2. Figure out what runner scope you need
- Repo-level: Runner scoped to a single repo — you need admin access
- Org-level: Runner shared across repos in an org — you need org owner access
- Enterprise-level: Runner shared across orgs in an enterprise — you need enterprise access
3. Register the runner
Read the architecture reference for the registration flow.
4. Route jobs to the runner
Use runs-on with labels and optionally groups. Read management labels section.
5. Monitor and troubleshoot
Read the management troubleshooting section when things go wrong.
6. Plan for security and scaling
Read security and scaling for production deployments.
Templates
- templates/docker-compose.yml — Docker runner with
myoung34/github-runner - templates/custom-runner.Dockerfile — Custom runner image for ARC
Reference Files
| File | Load when |
|---|---|
| references/architecture.md | You need to understand registration flow, job lifecycle, or runner communication |
| references/deployment.md | You need to deploy a runner — systemd, Docker, ARC, or Scale Set Client |
| references/security.md | You need to harden runners, set up ephemeral/JIT, configure groups |
| references/scaling.md | You need autoscaling — ARC, Scale Set Client, or webhook-driven |
| references/management.md | You need groups, labels, monitoring, troubleshooting, or cleanup |
| references/custom-images.md | You need a custom runner Dockerfile, ARC Kubernetes mode |
| references/network.md | You need firewall rules, proxy config, or are troubleshooting connectivity |
© magnus919, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 11 other files (references) in github-runner of magnus919/agent-skills.
- SKILL.md
- README.md
- evals/evals.json
- references/architecture.md
- references/custom-images.md
- references/deployment.md
- references/management.md
- references/network.md
- references/scaling.md
- references/security.md
- templates/custom-runner.Dockerfile
- templates/docker-compose.yml
Open the folder on GitHubat commit 96fbe07
Compare with similar skills
GitHub Runner 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| GitHub Runner this skillmagnus919/agent-skills | 111 | — | ~1.7k | Automated safety check: Pass | MIT | |
| Project Referencesaiskillstore/marketplace | 430 | — | ~2.3k | Automated safety check: Notes | None | |
| Data Processingaiskillstore/marketplace | 430 | 1 repos | ~720 | Automated safety check: Notes | MIT | |
| Releasing MarchatCod-e-Codes/marchat | 137 | — | ~801 | Automated safety check: Pass | MIT | |
| Devops Automationrohitg00/awesome-claude-code-toolkit | 2.7k | — | ~1.6k | Automated safety check: Pass | Apache-2.0 | |
| Devops Excellencemajiayu000/spellbook | 286 | — | ~2.4k | Automated safety check: Notes | MIT |
Similar skills
Data Processing
aiskillstore/marketplace
Process JSON with jq and YAML/TOML with yq. An agent skill from aiskillstore/marketplace.
Releasing Marchat
Cod-e-Codes/marchat
Prepares marchat releases: version bumps, CHANGELOG, packaging checksums, GitHub Actions release workflow, and Docker tags.
Devops Automation
rohitg00/awesome-claude-code-toolkit
CI/CD pipeline design with GitHub Actions, Docker, Kubernetes, Helm, and GitOps patterns
Devops Excellence
majiayu000/spellbook
DevOps and CI/CD expert. An agent skill from majiayu000/spellbook.
Devops Deployment
yonatangross/orchestkit
A skill your agent uses when setting up CI/CD pipelines, containerizing applications, deploying to Kubernetes, or writing infrastructure as code.
More from magnus919/agent-skills
All 129 skills in this repoArtifact Pyramids
magnus919/agent-skills
Organize durable agent research outputs as summaries, analysis, and evidence dossiers.
Ascii City Engine
magnus919/agent-skills
Build portable, first-person colored ASCII city engines and small GIS-derived city packs.
Color Management
magnus919/agent-skills
Manage color workflows with ICC profiles, working spaces, gamut mapping, and color science.
Data Scientist
magnus919/agent-skills
A skill your agent uses for PhD-level expertise in data science, statistics, and machine learning: rigorous statistical analysis, experimental design, causal inference, advanced modeling, research…
Docker Compose
magnus919/agent-skills
Use Docker Compose to define, run, debug, and harden multi-container applications.
Fpga Development
magnus919/agent-skills
Design, review, simulate, and verify FPGA logic using explicit RTL contracts, clock and reset models, CDC analysis, timing constraints, and reproducible implementation evidence.
Related
Categories
Questions about GitHub Runner
What does GitHub Runner do?
Deploy, manage, and troubleshoot self-hosted GitHub Actions runners. GitHub Runner is an agent skill from magnus919/agent-skills. Deploy, manage, and troubleshoot self-hosted GitHub Actions runners.
When should I use GitHub Runner?
GitHub Runner fits situations like: setting up a CI runner; debugging registration failures; designing autoscaling; hardening runner security.
How do I install GitHub Runner in Claude Code?
Run `npx skills add magnus919/agent-skills --skill github-runner -a claude-code`. Or copy the skill folder (github-runner in magnus919/agent-skills) into .claude/skills/github-runner in your project. Claude Code loads it when a task matches its description.
How do I install GitHub Runner in Codex?
Run `npx skills add magnus919/agent-skills --skill github-runner -a codex`. Or copy the skill folder (github-runner in magnus919/agent-skills) into .agents/skills/github-runner in your project. Codex loads it when a task matches its description.
Can I use GitHub Runner 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 magnus919/agent-skills --skill github-runner -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/github-runner, .gemini/skills/github-runner, .github/skills/github-runner and .opencode/skills/github-runner in your project.
What does GitHub Runner need to run?
Going by SKILL.md and its folder, GitHub Runner needs the command-line tools its instructions call (gh and docker) and credentials named ACCESS_TOKEN and RUNNER_TOKEN. Our summary lists: Docker; A credential in ACCESS_TOKEN; A credential in RUNNER_TOKEN. Compatibility (from SKILL.md): Linux, macOS, or Windows target hosts. Docker for containerized runners. Kubernetes for ARC deployments..
Does GitHub Runner access the network?
SKILL.md contains no URLs. Its commands use gh and docker, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is GitHub Runner 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 GitHub Runner use?
GitHub Runner is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does GitHub Runner use?
About 1.7k tokens (SKILL.md is roughly 7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 8k tokens, read only when the agent opens those files.
What are the alternatives to GitHub Runner?
Skills that share tags, products or a category with GitHub Runner: Project References (aiskillstore/marketplace, 430 stars), Data Processing (aiskillstore/marketplace, 430 stars), Releasing Marchat (Cod-e-Codes/marchat, 137 stars) and Devops Automation (rohitg00/awesome-claude-code-toolkit, 2.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains GitHub Runner?
magnus919 (a GitHub user) maintains it in magnus919/agent-skills, which has 111 GitHub stars. The repository holds 129 skills in this directory. The repository was last updated on October 6, 2026.
Source: magnus919/agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.