---
name: "runner-scale-set-gha-kubernetes"
description: "Autoscale ephemeral, self-hosted GitHub Actions runners inside Kubernetes clusters with ARC."
metadata:
  author: "Actions"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "install actions runner controller arc"
  - "autoscalingrunnerset kubernetes"
  - "self-hosted gha runners"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: false
  net_access: false
---

# Actions Runner Controller (ARC) Autoscaling on Kubernetes

Deploys GitHub Actions Runner Controller (ARC): installing AutoscalingRunnerSet CRDs, authenticating with GitHub App credentials, scaling runner pods from 0 to 100 based on job queues, and security sandboxing.

## When to Invoke
Invoke this skill whenever you need to:
- install actions runner controller arc
- autoscalingrunnerset kubernetes
- self-hosted gha runners

## Execution SOP & Rules
1. Install ARC controller and runner scale set listener via official Helm charts.
2. Create Kubernetes secret containing GitHub App ID, Private Key, and Installation ID.
3. Deploy AutoscalingRunnerSet CRD specifying githubConfigUrl: https://github.com/my-org and minRunners: 0.
4. In workflow YAML: configure runs-on: my-runner-set to target in-cluster self-hosted runners.

## Verification Checklist
- Run local linting, syntax validation, and type-checks before reporting completion.
- Ensure all created or modified files adhere to workspace boundaries and avoid uncommitted secrets.
- Verify tests or build commands exit cleanly with return code 0.