Terminal.skills
Skills/act
>

act

Run GitHub Actions locally with act. Use when a user asks to test GitHub Actions workflows locally, debug CI pipelines without pushing, or run workflows offline.

#act#github-actions#ci#local#docker
terminal-skillsv1.0.0
Works with:claude-codeopenai-codexgemini-clicursor
Source

Usage

$
✓ Installed act v1.0.0

Getting Started

  1. Install the skill using the command above
  2. Open your AI coding agent (Claude Code, Codex, Gemini CLI, or Cursor)
  3. Reference the skill in your prompt
  4. The AI will use the skill's capabilities automatically

Example Prompts

  • "Review the open pull requests and summarize what needs attention"
  • "Generate a changelog from the last 20 commits on the main branch"

Information

Version
1.0.0
Author
terminal-skills
Category
Development
License
Apache-2.0

Documentation

Overview

Act runs GitHub Actions workflows locally using Docker. Test and debug CI pipelines without pushing to GitHub. Supports most GitHub Actions features.

Instructions

Step 1: Install

bash
brew install act

Step 2: Run Workflows

bash
act                          # run push event
act pull_request             # run PR event
act -j test                  # run specific job
act -W .github/workflows/ci.yml  # specific workflow
act --secret-file .env.secrets   # with secrets

Step 3: Configuration

bash
# .actrc — Default settings
-P ubuntu-latest=catthehacker/ubuntu:act-latest
--env-file .env

Step 4: Debug

bash
act -n    # dry run
act -v    # verbose
act -l    # list workflows

Guidelines

  • First run downloads Docker images (~1-3GB).
  • Not all GitHub Actions features work locally (e.g., OIDC tokens).
  • Use micro images for faster runs.
  • Great for iterating on CI without waiting for GitHub runners.