/install github-wf
GitHub Skill
gh CLI for all operations. Always --repo owner/repo outside a git directory.
Security (always)
- Auth:
gh auth login --weborGITHUB_TOKENenv var - Secrets:
gh secret set NAME --repo owner/repo(interactive, never--body) - Never print/log tokens.
gh auth statusto verify.
Quick Reference
| Task | Command |
|---|---|
| Auth check | gh auth status |
| List PRs | gh pr list --repo o/r |
| Create PR | gh pr create --repo o/r --title "..." --base develop --head branch |
| PR checks | gh pr checks \x3Cn> --repo o/r |
| Merge (squash) | gh pr merge \x3Cn> --squash --delete-branch --repo o/r |
| Failed CI logs | gh run view \x3Cid> --log-failed --repo o/r |
| Re-run failed | gh run rerun \x3Cid> --failed-only --repo o/r |
| Create issue | gh issue create --repo o/r --title "..." --body "..." |
| Create release | gh release create vX.Y.Z --repo o/r --title "..." --notes "..." |
| Set secret | gh secret set KEY --repo o/r |
| Branch protect | gh api --method PUT repos/o/r/branches/main/protection ... |
Branching Model
main ← production, protected
develop ← integration
feature/* ← from develop
fix/* ← from develop (reference issue: fix/123-desc)
hotfix/* ← from main (emergency)
release/* ← from develop (prep)
Commit convention: feat: description (#42) / fix: description (#42)
PR merge: --squash for features, --merge for releases.
Semver: MAJOR.MINOR.PATCH — breaking/feature/fix.
When to read reference files
Load only what you need for the current task:
| Task | Read |
|---|---|
| Setting up a new repo, branch protection | references/repo-setup.md |
| PRs, reviews, merge strategies | references/pull-requests.md |
| CI runs, GitHub Actions | references/ci-actions.md |
| Releases, versioning, tags | references/releases.md |
| Secrets, environments | references/secrets-envs.md |
| JSON queries, audit, search | references/api-queries.md |
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install github-wf - After installation, invoke the skill by name or use
/github-wf - Provide required inputs per the skill's parameter spec and get structured output
What is GitHub Workflow?
Professional GitHub workflows via gh CLI. Use for repos, branches, PRs, CI/CD, releases, versioning, secrets, issues. Trigger on: GitHub, git, repo, PR, bran... It is an AI Agent Skill for Claude Code / OpenClaw, with 102 downloads so far.
How do I install GitHub Workflow?
Run "/install github-wf" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is GitHub Workflow free?
Yes, GitHub Workflow is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does GitHub Workflow support?
GitHub Workflow is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created GitHub Workflow?
It is built and maintained by Kretka (@kretkas); the current version is v1.2.0.