local-action-verification
Set up a repository for local GitHub Actions verification using act, so Jules can validate CI before pushing
- License 许可
- MIT
- 最近更新
- 2026-11-05
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- local-action-verification
- description
- Set up a repository for local GitHub Actions verification using act, so Jules can validate CI before pushing
- allowed-tools
- [ "Bash", "Read", "Write" ]
02 资源文件 4
- 参考文档README.md3.0 KB
- 参考文档resources/troubleshooting.md2.7 KB
- 脚本scripts/install-act.sh2.0 KB
- 脚本scripts/run-act.sh2.8 KB
03 SKILL.md 正文
Local Action Verification with act
You are setting up a repository so that Jules (or any agent) can run GitHub Actions workflows locally using act to verify code changes pass CI before pushing.
What You're Setting Up
Two scripts and an agents.md section that enable local CI verification:
- install-act.sh — Installs
actif missing (platform-aware, sudo fallback) - run-act.sh — Runs
actin the background with log polling to avoid agent timeouts - AGENTS.md section — Instructions Jules reads to know how to use these scripts
Setup Steps
Step 1: Copy scripts to the repository
Copy the scripts/ directory from this skill into the target repository at scripts/act/:
Target structure:
scripts/act/
├── install-act.sh
└── run-act.sh
Make sure the scripts are executable:
chmod +x scripts/act/install-act.sh scripts/act/run-act.sh
Step 2: Add instructions to AGENTS.md
Append the following section to the repository's AGENTS.md file (create it if it doesn't exist). This is how Jules discovers the local verification capability:
## Local CI Verification
Before pushing code or opening a PR, verify changes pass CI locally using `act`.
### Prerequisites
- Docker must be running
- If `act` is not installed, run: `bash scripts/act/install-act.sh`
### How to Verify
1. Read `.github/workflows/` to find the CI workflow and identify the job ID
2. Run the verification script:
```bash
bash scripts/act/run-act.sh "push -j <JOB_ID>"
With matrix: bash scripts/act/run-act.sh "push -j <JOB_ID> --matrix <KEY>:<VALUE>"
3. If the run fails, read the log output, fix the code, and re-run
4. After verification, clean up:
rm -f act_output.log
git checkout <any unintended file changes>
Configuration
- Timeout:
ACT_TIMEOUT=900 bash scripts/act/run-act.sh "..."(default: 600s) - Poll interval:
ACT_POLL=15 bash scripts/act/run-act.sh "..."(default: 10s) - Custom image: pass
-P ubuntu-latest=node:20-bookwormin the arguments for faster pulls
### Step 3: Update .gitignore
Append these entries to `.gitignore` if they don't already exist:
act artifacts
act_output.log .secrets
### Step 4: Print next steps for the user
Tell the user:
1. Docker must be installed and running on any machine (or Jules VM) where verification runs
2. `act` will be auto-installed on first use via `scripts/act/install-act.sh`
3. If workflows require secrets, create a `.secrets` file (KEY=VALUE format) — never commit it
4. Commit all generated files
## Troubleshooting
- **Docker not running**: `act` requires Docker. Ensure the Docker daemon is started.
- **Image pull slow**: First run downloads ~2GB+. Use `-P ubuntu-latest=node:20-bookworm` for faster pulls.
- **ARM64 issues**: On Apple Silicon, add `--container-architecture linux/amd64` to act arguments.
- **Secrets required**: Create a `.secrets` file and pass `--secret-file .secrets` in the act arguments.
- **Timeout**: Increase with `ACT_TIMEOUT=1200 bash scripts/act/run-act.sh "..."`.
## Resource References
- [Troubleshooting Guide](resources/troubleshooting.md) — Detailed solutions for common issues
04 同仓库更多 Skills
taste-design
Semantic Design System Skill for Google Stitch. Generates agent-friendly DESIGN.md files that enforce premium, anti-generic UI standards — strict typography, calibrated color, asymmetric layouts, perpetual micro-motion, and hardware-accelerated performance.
stitch-loop
Teaches agents to iteratively build websites using Stitch with an autonomous baton-passing loop pattern
site-md
Analyze a project description or site requirements and synthesize a project constitution into SITE.md for the Stitch Build Loop
enhance-prompt
Transforms vague UI ideas into polished, Stitch-optimized prompts. Enhances specificity, adds UI/UX keywords, injects design system context, and structures output for better generation results.
design-md
Analyze Stitch projects and synthesize a semantic design system into DESIGN.md files
stitch::upload-to-stitch
Upload local assets (images, mockups, extracted HTML, design markdown) to a Stitch project. ALWAYS use this skill when you need to upload visual assets, HTML pages, or design docs to Stitch, particularly when direct MCP tool calls fail or truncate due to base64 token limits.