github-runner-setup

Automate setup, security hardening, and monitoring of macOS GitHub Actions self-hosted runners.

2|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/amdmax/claude_marketplace --skill github-runner-setup-amdmax
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: github-runner-setup
Source: https://github.com/amdmax/claude_marketplace/tree/main/.claude/skills/github%3Arunner-setup
Command: npx skills add https://github.com/amdmax/claude_marketplace --skill github-runner-setup-amdmax

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the complex and time-consuming process of setting up self-hosted GitHub Actions runners on macOS, ensuring they are secure, monitored, and ready for use.

Core Features & Use Cases

  • Automated Installation: Installs and configures GitHub Actions runners with specified labels and groups.
  • Security Hardening: Includes steps for firewall configuration and permission setting.
  • Monitoring Setup: Automates the setup of scripts to monitor runner health and rotate logs.
  • Workflow Migration Guidance: Provides a phased approach and examples for migrating existing workflows to self-hosted runners.
  • Use Case: You need to set up a new macOS machine to act as a self-hosted runner for your organization, capable of running Node.js builds and AWS deployments. This Skill handles the entire setup from downloading the runner to configuring monitoring.

Quick Start

Use the install_runner.sh script to set up a new GitHub Actions runner for your organization named 'macos-prod-runner-01' with labels 'macos-arm64,node-22,aws-deployment'.

Frequently Asked Questions about github-runner-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a self-hosted GitHub Actions runner on macOS?

Setting up a self-hosted GitHub Actions runner on macOS involves downloading the action runner, configuring it with registration tokens, and assigning custom labels for targeted workflow routing.

Can I automate security hardening when configuring a macOS GitHub Actions runner?

Yes, you can automate security hardening for a macOS GitHub Actions runner by applying predefined scripts that configure firewall rules and set strict file permissions to protect the execution environment.

What is the best way to monitor self-hosted runner health and manage logs on macOS?

The best way to monitor self-hosted runner health and manage logs is to deploy automated monitoring scripts that track runner status and configure log rotation to prevent disk space exhaustion on macOS.

How do I migrate existing GitHub Actions workflows to a self-hosted macOS runner?

To migrate existing GitHub Actions workflows to a self-hosted macOS runner, you apply a phased approach using provided examples to update workflow configurations with specific runner labels and groups.

Does this macOS runner setup support organization-level runners and repository-level runners?

Yes, this macOS runner setup supports both organization-level and repository-level GitHub Actions runners, allowing you to configure custom labels and assign runners to specific runner groups for access control.

Why do I need custom labels when configuring a self-hosted GitHub Actions runner?

You need custom labels when configuring a self-hosted GitHub Actions runner to route specific jobs, such as Node.js builds or AWS deployments, to the correct macOS machine based on its configured capabilities.