Agent skill
gh-workflow
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.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/gh-workflow
SKILL.md
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
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?