1---2name: github-workflow3description: "GitHub interactions for issues, PRs, releases, and repository management"4triggers:5 - "github workflow"6 - "github help"7 - "gh operations"8user_invocable: true9---1011# GitHub Workflow1213A comprehensive suite of GitHub workflow skills using the `gh` CLI and GitHub MCP tools.1415## Input Sanitization1617- Repository names: `owner/repo` format, alphanumeric with hyphens and underscores only — reject shell metacharacters and null bytes18- Issue/PR numbers: positive integers only19- Labels and milestone names: alphanumeric, hyphens, underscores, spaces, and colons only2021## Available Skills2223### Issue Management24| Skill | Purpose | Invoke |25|-------|---------|--------|26| `/gh-issue` | Create/link/close issues | `gh-issue`, `create issue` |27| `/gh-triage` | Batch label and prioritize | `gh-triage`, `triage issues` |2829### Pull Request Workflow30| Skill | Purpose | Invoke |31|-------|---------|--------|32| `/gh-pr-status` | Check PR status, CI, merge readiness | `gh-pr-status`, `pr status` |33| `/gh-pr-request` | Request reviewers | `gh-pr-request`, `request review` |34| `/gh-pr-respond` | View/respond to review comments | `gh-pr-respond`, `pr comments` |35| `/gh-pr-merge` | Merge PR with strategy | `gh-pr-merge`, `merge pr` |36| `/gh-pr-update` | Update PR branch with base | `gh-pr-update`, `update pr` |3738### Releases & Tags39| Skill | Purpose | Invoke |40|-------|---------|--------|41| `/gh-release` | Create release with changelog | `gh-release`, `new release` |42| `/gh-tag` | Semantic version tagging | `gh-tag`, `create tag` |43| `/gh-changelog` | Generate changelog from PRs | `gh-changelog`, `release notes` |4445### Repository Status46| Skill | Purpose | Invoke |47|-------|---------|--------|48| `/gh-health` | Repository health dashboard | `gh-health`, `repo status` |49| `/gh-mine` | My assigned/mentioned items | `gh-mine`, `my issues` |50| `/gh-activity` | Recent activity summary | `gh-activity`, `what happened` |5152## Quick Reference5354```bash55# Issue workflow56/gh-issue create # Create new issue57/gh-triage # Triage open issues5859# PR workflow60/gh-pr-status # Check current PR61/gh-pr-request @user # Request review62/gh-pr-respond # Handle comments63/gh-pr-merge # Merge when ready6465# Release workflow66/gh-changelog # Generate notes67/gh-tag v1.2.0 # Create tag68/gh-release # Create release6970# Dashboard71/gh-health # Repo overview72/gh-mine # My items73/gh-activity # Recent activity74```7576## Gotchas7778- `gh` commands without `--json` output human-readable tables that are unreliable to parse — always use `--json field1,field2` for programmatic use79- `gh api` results are paginated (30 items default) — use `--paginate` for complete results or `--jq` to filter80- `gh pr create` from a branch with no upstream fails — always `git push -u origin <branch>` first81- `gh pr merge --auto` requires branch protection rules enabled on the repo — fails silently without them82- `hub` CLI syntax is deprecated and incompatible with `gh` — never suggest `hub` commands83- `gh issue create --label` fails if the label doesn't exist — create labels first with `gh label create`8485## Related Skills8687- `/commit` - Create commits with conventional messages88- `/commit-push-pr` - Full commit, push, and PR workflow89- `/git-*` - Local git operations90- `/review-pr` - Review pull requests
dtsong