GitHub Workflow Skill

When to Use

• Creating/managing GitHub issues
• Preparing PRs with proper format
• Managing milestones and labels

Issue Management

Create Issue

gh issue create --title "[Area] Description" \
  --body "$(cat <<'EOF'
## Task
What needs to be done

## Acceptance Criteria
- [ ] Criteria 1
- [ ] Criteria 2

## Files
`src/core/file.py`
EOF
)" --label "enhancement"

Edit Issue

# Add labels
gh issue edit 123 --add-label "bug,P0"

# Add to milestone
gh issue edit 123 --milestone "v1.0"

# Close
gh issue close 123

List Issues

# By label
gh issue list --label "bug"

# By milestone
gh issue list --milestone "v1.0"

# JSON for scripting
gh issue list --json number,title,labels

Pull Requests

Create PR

gh pr create \
  --title "feat(core): add feature description" \
  --body "$(cat <<'EOF'
## Summary
- What changed

## Test Plan
- [ ] pytest passes
- [ ] pyright passes
- [ ] ruff passes

## Related Issues
Closes #XX

🤖 Generated with [Claude Code](https://claude.com/claude-code)
EOF
)"

Check PR Status

gh pr status
gh pr view 123
gh pr checks 123

View PR Comments

gh api repos/:owner/:repo/pulls/123/comments

Merge PR

gh pr merge 123 --squash --delete-branch

Git Workflow for PRs

Standard Flow

# 1. Checkout main and pull
git checkout main && git pull origin main

# 2. Create feature branch
git checkout -b feature/description

# 3. Make changes and commit
git add . && git commit -m "feat(scope): description"

# 4. Push and create PR
git push -u origin feature/description
gh pr create --title "..." --body "..."

Branch Naming

feature/{description}
fix/{issue-number}-{description}
docs/{description}
refactor/{description}

Commit Message Format

{type}({scope}): {description}

[optional body]

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Types:

feat

,

fix

,

docs

,

refactor

,

test

,

chore

Pre-PR Validation

source venv/bin/activate

# All must pass
ruff format src tests
ruff check src tests --fix
pyright src tests
pytest

# Review changes
git diff --stat

Labels

Create Labels

# Priority
gh label create "P0" --description "Critical" --color "E11D48"
gh label create "P1" --description "Important" --color "F97316"
gh label create "P2" --description "Enhancement" --color "3B82F6"

# Type
gh label create "bug" --description "Something broken" --color "D73A4A"
gh label create "enhancement" --description "New feature" --color "A2EEEF"
gh label create "docs" --description "Documentation" --color "0075CA"

Quick Reference

# Issues
gh issue create --title "..." --body "..." --label "..."
gh issue edit 123 --add-label "bug"
gh issue list --label "bug"

# PRs
gh pr create --title "..." --body "..."
gh pr view 123
gh pr merge 123 --squash
gh api repos/:owner/:repo/pulls/123/comments