github-actions
Create, debug, and test GitHub Actions workflows and custom actions. Use when building CI/CD pipelines, automating workflows, or troubleshooting GitHub Actions.
How do I install this agent skill?
npx skills add https://github.com/openhands/extensions --skill github-actionsIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a comprehensive documentation and guide for GitHub Actions, emphasizing security best practices and effective debugging. It provides command templates for the official GitHub CLI and the well-known local runner 'act', without introducing any malicious code or unsafe patterns.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
GitHub Actions Guide
Critical Rules
Custom Action Deployment:
- New custom actions MUST be merged to the main branch before they can be used
- After the initial merge, they should be tested from feature branches
Debug Steps: Add debug steps that print non-secret parameters when:
- Creating a new action, OR
- Troubleshooting a particularly tricky issue
(Not required for every workflow - use when needed)
Effectiveness Principles
Actions cost CI minutes. Be deliberate, not iterative:
- Monitor, don't poll - use
gh run watch/gh pr checks --watchto follow runs live - Read logs, don't guess - fetch the failed job's log before changing code
- Print actual values - debug steps reveal the real
inputs/githubcontext, not your assumptions - Test locally first -
actruns workflows on your machine and avoids burning CI minutes - Plan the smallest reproduction - one job, minimal matrix, narrow trigger before scaling up
See README.md for the full debugging workflow, gh commands, and YAML debug-step examples.
Key Gotchas
- Secrets unavailable in fork PRs -
pull_requesthas no secrets for forks;pull_request_targetdoes but never check out or execute fork PR code inside it (RCE with write permissions) - Pin action versions - Use
@v4or SHA, not@main(prevents breaking changes) - Explicit permissions - Set
permissions:block for GITHUB_TOKEN operations - Artifacts for job-to-job data - Files don't persist between jobs without
upload-artifact/download-artifact
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/openhands/extensions/github-actions">View github-actions on skillZs</a>