← Back to Skills Marketplace
kretkas

GitHub Workflow

by Kretka · GitHub ↗ · v1.2.0 · MIT-0
cross-platform ✓ Security Clean
102
Downloads
1
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install github-wf
Description
Professional GitHub workflows via gh CLI. Use for repos, branches, PRs, CI/CD, releases, versioning, secrets, issues. Trigger on: GitHub, git, repo, PR, bran...
README (SKILL.md)

GitHub Skill

gh CLI for all operations. Always --repo owner/repo outside a git directory.

Security (always)

  • Auth: gh auth login --web or GITHUB_TOKEN env var
  • Secrets: gh secret set NAME --repo owner/repo (interactive, never --body)
  • Never print/log tokens. gh auth status to 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
Usage Guidance
This skill appears benign and purpose-aligned for GitHub work. Before installing or using it, make sure the active GitHub account/token has only the permissions needed, verify the target repository for every command, and require explicit confirmation before merges, releases, workflow changes, secret updates, branch-protection changes, or deletion/archive actions.
Capability Analysis
Type: OpenClaw Skill Name: github-workflow-main Version: 1.2.0 The skill bundle provides a comprehensive and well-documented set of instructions for managing GitHub workflows using the 'gh' CLI. It includes explicit security best practices (e.g., pinning Actions to SHAs, avoiding token logging) and consistently mandates user confirmation for sensitive or destructive operations like deleting repositories, merging PRs, or setting secrets across all reference files (e.g., SKILL.md, repo-setup.md, secrets-envs.md).
Capability Tags
requires-sensitive-credentials
Capability Assessment
Purpose & Capability
The documented capabilities match the stated GitHub workflow purpose, including PRs, issues, CI, releases, secrets, and branch protection. Some actions are high-impact but are disclosed.
Instruction Scope
The skill documents broad gh CLI/API operations. Many destructive or publishing operations explicitly say to confirm with the user first, which keeps the behavior purpose-aligned.
Install Mechanism
There is no install spec and no code files, so there is no hidden executable payload in the provided artifacts. However, the metadata does not declare the gh binary or GitHub credential requirement even though SKILL.md expects them.
Credentials
GitHub authentication via gh auth or GITHUB_TOKEN is expected for this skill, and the instructions include safeguards not to print or log tokens.
Persistence & Privilege
No background persistence or autonomous worker is present, but the skill can make persistent changes to GitHub repositories, such as merges, releases, branch protection, secrets, workflow settings, or deletion when directed.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install github-wf
  3. After installation, invoke the skill by name or use /github-wf
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.0
# Changed - Split into `SKILL.md` (core) + 6 reference files — only the relevant section is loaded - ~70% token reduction on typical tasks # Added - `⚠️ CONFIRM WITH USER` warnings before all write/delete operations - Git Flow branching strategy: `main → develop → feature/fix/hotfix/release` - Branch protection via `gh api` - Semantic versioning with MAJOR/MINOR/PATCH table - Full 10-step workflow: issue → branch → PR → merge → release - CI best practices checklist for `.github/workflows/` - Security rules: no token exposure, `gh auth login --web` only # Removed - Monolithic single-file structure
v1.1.0
**Summary:** Added comprehensive reference documentation and migrated to professional `gh` CLI workflows. - Switched to the `gh` CLI for all GitHub operations; removed previous MorphixAI integration. - Added six reference files covering repo setup, pull requests, CI actions, releases, secrets, and API queries. - Documented security best practices: authentication, secret handling, branch protection. - Provided concise command references for common GitHub tasks. - Detailed standard branching model and commit conventions.
Metadata
Slug github-wf
Version 1.2.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

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.

💬 Comments