Skill119 repo starsupdated 2d ago

act

Act is a tool that executes GitHub Actions workflows locally using Docker, enabling developers to test and debug continuous integration pipelines on their machines before pushing code to GitHub. Use it to validate workflow configurations, iterate on CI logic quickly, and reduce feedback cycles without relying on remote GitHub runners.

View source Repository: skills

Install in Claude Code

Copy

git clone --depth 1 https://github.com/TerminalSkills/skills /tmp/act && cp -r /tmp/act/skills/act ~/.claude/skills/act

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.md

# Act

## 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.