github-act

Run and debug GitHub Actions workflows locally with the gh act CLI.

30|6|Updated Jan 21, 2026

Search Tags:#ci/cd #debugging #github actions #workflow testing #local execution #gh act

Ready to run

npx skills add https://github.com/Krastanov/JuliaLLMAgentSkills --skill github-act

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: github-act
Source: https://github.com/Krastanov/JuliaLLMAgentSkills/tree/main/github-act
Command: npx skills add https://github.com/Krastanov/JuliaLLMAgentSkills --skill github-act

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill allows you to run and debug GitHub Actions workflows locally on your machine, before committing and pushing them to your repository. This significantly speeds up the development and testing cycle for CI/CD pipelines.

Core Features & Use Cases

Local Workflow Execution: Run any GitHub Actions workflow defined in your .github/workflows directory using the gh act command-line tool.
CI/CD Validation: Validate workflow syntax, test job logic, and reproduce CI failures without relying on remote runners.
Iterative Development: Quickly iterate on workflow YAML files by running them locally, making it easier to catch errors and refine your CI/CD processes.

Quick Start

Use the github-act skill to run the default push event workflow.

Frequently Asked Questions about github-act

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

FAQPage Schema

How do I run GitHub Actions workflows locally to test CI configurations?▼

Run GitHub Actions workflows locally using the `gh act` CLI tool to validate CI configurations, test job logic, and iterate on YAML files before pushing changes to your repository.

Can I debug GitHub Actions workflow failures without using remote runners?▼

Debug GitHub Actions failures without remote runners by reproducing CI errors locally with the `gh act` extension, allowing you to catch syntax issues and refine workflow logic directly on your machine.

Do I need Docker to execute GitHub Actions workflows on my local machine?▼

Yes, executing GitHub Actions workflows locally requires Docker or a compatible container runtime, along with the `gh-act` extension installed, to run the defined CI/CD jobs.

What is the best way to validate workflow YAML files before pushing to GitHub?▼

The best way to validate workflow YAML files before pushing is local execution via `gh act`, which lets you run the default push event workflow to catch errors and test job logic quickly.

Why does my local GitHub Actions workflow execution fail to start?▼

Local GitHub Actions execution fails if Docker or a compatible container runtime is missing, or if the `gh-act` extension is not properly installed to run the workflow definitions.