TerminalSkills/skills

Execute fluxos de trabalho do GitHub Actions localmente com o act. Use quando um usuário pedir para testar fluxos de trabalho do GitHub Actions localmente, depurar pipelines de CI sem enviar para o repositório ou executar fluxos de trabalho offline.

O que é skills?

Esta skill permite executar fluxos de trabalho do GitHub Actions localmente usando a ferramenta de linha de comando `act`, que utiliza contêineres Docker para simular o ambiente de execução do GitHub Actions. Ela é extremamente útil para desenvolvedores que desejam testar e depurar pipelines de CI (Integração Contínua) sem precisar fazer push para o GitHub, economizando tempo e recursos. A skill suporta a maioria dos recursos do GitHub Actions, incluindo diferentes eventos (push, pull_request), seleção de jobs específicos, workflows personalizados e arquivos de segredos. Ela fornece instruções claras para instalação (via Homebrew), execução de workflows, configuração com arquivo `.actrc` e opções de depuração como execução simulada (dry run) e saída detalhada. As orientações incluem que o primeiro download de imagens Docker pode ser grande (1-3 GB), que nem todos os recursos avançados (como tokens OIDC) funcionam localmente, e que usar imagens pequenas (micro) acelera as execuções, sendo ideal para iterar rapidamente no CI sem depender dos runners do GitHub.

Funciona com~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/TerminalSkills/skills/tree/HEAD/skills/act

Documentação

Act

Visão Geral

O Act executa fluxos de trabalho do GitHub Actions localmente usando Docker. Teste e depure pipelines de CI sem enviar para o GitHub. Suporta a maioria dos recursos do GitHub Actions.

Instruções

Passo 1: Instalar

brew install act

Passo 2: Executar Workflows

act                          # executar evento push
act pull_request             # executar evento PR
act -j test                  # executar job específico
act -W .github/workflows/ci.yml  # workflow específico
act --secret-file .env.secrets   # com segredos

Passo 3: Configuração

# .actrc — Configurações padrão
-P ubuntu-latest=catthehacker/ubuntu:act-latest
--env-file .env

Passo 4: Depuração

act -n    # execução simulada (dry run)
act -v    # modo detalhado
act -l    # listar workflows

Diretrizes

A primeira execução baixa imagens Docker (~1-3 GB).
Nem todos os recursos do GitHub Actions funcionam localmente (por exemplo, tokens OIDC).
Use imagens micro para execuções mais rápidas.
Ideal para iterar no CI sem esperar pelos runners do GitHub.