How do I install the Github Workflow skill?

Run npx skillmds@latest add diegosouzapw/github-workflow-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Github Workflow safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Github Workflow?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Github Workflow free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Github Workflow?

diegosouzapw (@diegosouzapw) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Github Workflow by diegosouzapw — Agent Skill

Name: Github Workflow
Rating: 4.666666666666667 (3 reviews)
Author: diegosouzapw

File contents

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

---name: github-workflow-2description: Work with GitHub issues, PRs, and releases. Use when managing tasks, creating issues, or preparing PRs.--- # GitHub Workflow Skill ## When to Use - Creating/managing GitHub issues - Preparing PRs with proper format - Managing milestones and labels ## Issue Management ### Create Issue ```bash 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 ```bash # 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 ```bash # 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 ```bash 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 ```bash gh pr status gh pr view 123 gh pr checks 123 ``` ### View PR Comments ```bash gh api repos/:owner/:repo/pulls/123/comments ``` ### Merge PR ```bash gh pr merge 123 --squash --delete-branch ``` ## Git Workflow for PRs ### Standard Flow ```bash # 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 ```bash 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 ```bash # 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 ```bash # 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 ```

Frequently asked questions

Github Workflow