OpenParable
Skip to content
← Back to skills

GH Workflow

Apps & Automation
gh-workflow

GH Workflow is an Agent Skill for apps & automation published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

GitHub workflow using the gh CLI for PRs, issues, CI checks, and code review. Use this instead of the GitHub MCP — covers creating PRs with spec references, monitoring CI runs, and reviewing PR comments.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/integration/gh-workflow-agentic-engineering-agentforge/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/gh-workflow, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Use the gh CLI for all GitHub operations in AgentForge.


PR Workflow

List open PRs:

gh pr list

View PR details:

gh pr view [number]

Check CI status for a PR:

gh pr checks [number]

Create a PR (always use a HEREDOC for the body):

gh pr create --title "SPEC-NNN: Short description" --body "$(cat <<'EOF'
## Summary
- What this PR does

## Test plan
- [ ] pnpm test — all green
- [ ] tsc --noEmit — 0 errors
- [ ] pnpm audit — 0 high/critical
- [ ] Manual: agentforge start / chat / status
- [ ] Related spec: SPEC-NNN

🤖 Generated with Claude Code
EOF
)"

Merge a PR:

gh pr merge [number] --squash --delete-branch

Issue Workflow

List issues:

gh issue list
gh issue list --label "bug"

View an issue:

gh issue view [number]

Create an issue linked to a spec:

gh issue create --title "SPEC-NNN: Short description" \
  --body "Implements specs/active/SPEC-NNN-<title>.md"

Close an issue:

gh issue close [number]

CI / Actions Workflow

List recent runs:

gh run list --limit 5

Watch a run live:

gh run watch

View failed run logs:

gh run view [run-id] --log-failed

Code Review

View PR with all comments:

gh pr view [number] --comments

Add a review comment:

gh pr review [number] --comment -b "Your comment here"

Approve or request changes:

gh pr review [number] --approve
gh pr review [number] --request-changes -b "Please fix X before merging"

AgentForge PR Guidelines

  • Title must reference the related spec: SPEC-NNN: description
  • Body must include test plan: pnpm test, tsc --noEmit, pnpm audit, manual CLI test
  • Link to the spec file in specs/active/
  • Never force-push to main