About

Imported from terminalskills/skills (skills/act/SKILL.md). Install upstream with npx skills add terminalskills/skills --skill act. Copyright stays with the author (Apache-2.0).

Act

Name: act
Author: terminalskills

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

brew install act

Step 2: Run Workflows

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

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

Step 4: Debug

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.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/terminalskills-skills-act/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

terminalskills-skills-act.ocm.jsonjson

{
  "ocm": "1",
  "id": "terminalskills-skills-act",
  "kind": "skill",
  "name": "act",
  "description": "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.",
  "publisher": "terminalskills",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "act",
      "github-actions",
      "ci",
      "local",
      "docker",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "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."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/terminalskills/skills",
      "path": "skills/act/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/terminalskills/skills/blob/HEAD/skills/act/SKILL.md",
      "key": "terminalskills/skills/skills/act/SKILL.md"
    },
    "compatibility": "Docker required, any OS",
    "license": "Apache-2.0"
  },
  "instructions": "# Act\n\n## Overview\nAct runs GitHub Actions workflows locally using Docker. Test and debug CI pipelines without pushing to GitHub. Supports most GitHub Actions features.\n\n## Instructions\n\n### Step 1: Install\n```bash\nbrew install act\n```\n\n### Step 2: Run Workflows\n```bash\nact                          # run push event\nact pull_request             # run PR event\nact -j test                  # run specific job\nact -W .github/workflows/ci.yml  # specific workflow\nact --secret-file .env.secrets   # with secrets\n```\n\n### Step 3: Configuration\n```bash\n# .actrc — Default settings\n-P ubuntu-latest=catthe",
  "cost": {
    "context_tokens": 242
  }
}

Fetch it by URL: GET /api/v1/registry/terminalskills-skills-act/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.