manage-gh-runners

To provision a self-hosted runner, use the manage-gh-runners skill to execute raw docker run commands with the gh-runner image. You must provide a GitHub repository URL via REPO_URL, a registration token, and ensure Docker access on the CI host.

Deregistering GitHub Actions runners requires graceful cleanup to keep the runner UI in sync and avoid offline zombies. The manage-gh-runners skill automates this deregistration and state cleanup process on your CI host.

You can list, update, or swap gh-runner containers using the manage-gh-runners skill. It applies consistent labeling and state management to track and modify runner instances deployed via raw docker run.

The manage-gh-runners skill specifically targets raw docker run deployments using the gh-runner image. It provides guidance for flow selection to distinguish this approach from docker-compose based actions-runner configurations.

A GitHub repo URL via REPO_URL and a registration token are required to authenticate and link the self-hosted runner to your repository. The manage-gh-runners skill uses these credentials to provision and register the container.

If /data/miles_ci is not yet provisioned, the manage-gh-runners skill provides explicit setup steps and environment checks for host provisioning. This ensures the directory structure is ready before deploying runners.