Agent skill

GitHub PR Workflow

by AlexAI-MCP in AlexAI-MCP/hermes-CCC

Run a disciplined GitHub pull request workflow from branch creation through merge.

MITAuto-check passedDevelopment

Install GitHub PR Workflow

skills CLI
$ npx skills add AlexAI-MCP/hermes-CCC --skill github-pr-workflow -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install AlexAI-MCP/hermes-CCC github-pr-workflow --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/AlexAI-MCP/hermes-CCC.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/github-pr-workflow .claude/skills/github-pr-workflow && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
github-pr-workflow
GitHub stars
135
Token cost
~1.4k tokens
SKILL.md length
636 words
Files
1
Skills in repo
44
Repo updated
First seen
Licence
MIT

At a glance

Run a disciplined GitHub pull request workflow from branch creation through merge.

  • Works in 9 steps: Start from the correct base branch. → Keep the branch scope tight. → Make coherent commits. → …
  • Updating a PR after review
  • SKILL.md covers Purpose, Activation Signals, Core Workflow and Branch Rules, plus 15 more sections
  • Calls git and gh

What it does

GitHub PR Workflow is an agent skill from AlexAI-MCP/hermes-CCC. Run a disciplined GitHub pull request workflow from branch creation through merge. Use when opening a PR, updating a PR after review, preparing review-ready diffs, managing draft versus ready states, or landing changes with clear validation and risk notes.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development. It works with GitHub. The repository describes itself as: Hermes Agent ported to Claude Code Channel — 46 native skills, no OAuth, no external process. The licence is MIT.

When your agent uses it

  • Updating a PR after review
  • Preparing review-ready diffs
  • Managing draft versus ready states
  • Landing changes with clear validation and risk notes

Example prompts

  • “/github-pr-workflow”

Workflow steps

9 steps, taken from the first numbered list in SKILL.md.

  1. Start from the correct base branch.
  2. Keep the branch scope tight.
  3. Make coherent commits.
  4. Validate before opening the PR.
  5. Open a draft PR if the implementation is not review-ready.
  6. Write a useful PR title and description.
  7. Address review comments with focused follow-up commits.
  8. Re-validate before merge.
  9. Merge with the right strategy.

What it can do on your machine

Read from SKILL.md and the folder at commit 8107e89. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • gh

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git and gh, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

GitHub PR Workflow loads about 1.4k tokens when it runs. Until then it costs about 69 tokens; SKILL.md has 636 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~69
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from AlexAI-MCP/hermes-CCC at commit 8107e89, republished under its MIT licence (© AlexAI-MCP). 636 words, ~1,379 tokens.

Download SKILL.mdSave it as .claude/skills/github-pr-workflow/SKILL.md (or your agent's skills folder).
name
github-pr-workflow
description
Run a disciplined GitHub pull request workflow from branch creation through merge. Use when opening a PR, updating a PR after review, preparing review-ready diffs, managing draft versus ready states, or landing changes with clear validation and risk notes.
version
0.1.0
author
OpenAI Codex
license
MIT
metadata.category
github
metadata.ported_from
NousResearch Hermes Agent
metadata.tags
github, pull-request, workflow, collaboration
metadata.tools
git, github, shell
metadata.maturity
beta

GitHub PR Workflow

Purpose

  • Keep pull requests reviewable and easy to merge safely.
  • Separate implementation from presentation and merge hygiene.
  • Make reviewer intent clear through titles, descriptions, and test plans.
  • Reduce merge friction by handling updates systematically.
  • Preserve traceability between issue, code, and validation.

Activation Signals

  • Use this skill when opening a new branch for changes.
  • Use this skill when preparing a PR for review.
  • Use this skill when updating a PR after feedback.
  • Use this skill when turning a draft into a merge-ready PR.
  • Use this skill when planning labels, reviewers, and merge strategy.

Core Workflow

  1. Start from the correct base branch.
  2. Keep the branch scope tight.
  3. Make coherent commits.
  4. Validate before opening the PR.
  5. Open a draft PR if the implementation is not review-ready.
  6. Write a useful PR title and description.
  7. Address review comments with focused follow-up commits.
  8. Re-validate before merge.
  9. Merge with the right strategy.

Branch Rules

  • Branch from the intended base, not a stale local branch.
  • Name the branch after the work, not the date.
  • Keep unrelated changes out of the branch.
  • Avoid force-push unless the team allows it and history cleanup is worth it.

Commit Rules

  • One logical change per commit when practical.
  • Use commit messages that explain intent, not just files touched.
  • Avoid mixing refactor and bug fix unless inseparable.
  • Keep WIP commits local when possible.

Pre-PR Validation

  • run targeted tests
  • run lint if relevant
  • check formatting if the repo enforces it
  • read the diff yourself before asking others to do it
  • note any unverified areas explicitly

PR Title Rules

  • Lead with the user-visible or system-visible change.
  • Keep it specific.
  • Avoid "misc fixes".
  • Prefer imperative summaries such as "Fix auth redirect loop during token refresh".

PR Description Template

markdown
## Summary
- ...

## Why
- ...

## Testing
- `pytest tests/test_auth.py::test_login_redirect_does_not_loop_when_session_is_hydrated -vv`

## Risks
- ...

Draft Versus Ready

  • Open as draft when the implementation is incomplete.
  • Open as draft when feedback on direction is needed before polishing.
  • Convert to ready only after validation and self-review.
  • Do not ask for full review while the branch still contains known broken paths.

Review Update Procedure

  1. Group comments by theme.
  2. Resolve the highest-risk comments first.
  3. Make focused follow-up commits.
  4. Reply with what changed and where.
  5. Re-run the relevant validation.
  6. Avoid "fixed" with no evidence.
Show full SKILL.md (262 more words)Show less

Merge Strategy

  • Use merge commit when preserving branch history matters.
  • Use squash when the branch contains several noisy intermediate commits.
  • Use rebase when the repository prefers linear history and the branch is clean.
  • Follow repo policy when it is explicit.

Useful Commands

bash
git checkout -b fix-auth-redirect-loop
git status --short
git diff --stat
gh pr create --draft --title "Fix auth redirect loop during token refresh" --body-file PR_BODY.md
gh pr view --web

Reviewer Experience Rules

  • Keep the diff small enough to review in one sitting.
  • Explain why the change exists.
  • State how you validated it.
  • Admit unknowns.
  • Link related issues or incidents.

Anti-Patterns

  • giant PRs with mixed concerns
  • vague PR titles
  • empty descriptions
  • no testing notes
  • force-pushing away reviewer context without warning
  • mixing comment resolution with unrelated cleanup

Output Contract

When reporting PR progress, include:

  • branch name
  • PR state: draft or ready
  • summary of changes
  • validation performed
  • remaining risks or blockers

Example Status Block

markdown
PR workflow status:
- Branch: fix-auth-redirect-loop
- State: draft
- Summary: auth middleware now waits for hydrated session token before redirecting
- Validation: targeted auth regression test passed
- Remaining blocker: reviewer input needed on fallback behavior during refresh timeout

Decision Rules

  • If the diff is large, split before asking for review when possible.
  • If the PR changes behavior, tests should usually change too.
  • If validation is partial, state the gap explicitly.
  • If the branch drifted from base, rebase or merge base before final review.

Recovery Moves

  • If review comments are scattered, create a comment-response checklist.
  • If the branch became messy, squash or reorder before final merge if policy allows.
  • If new scope appears, consider a follow-up PR instead of growing the current one.
  • If CI fails, fix CI before asking for another full review pass.

Checklist

  1. Start from the correct base branch.
  2. Keep scope tight.
  3. Self-review the diff.
  4. Validate locally.
  5. Open draft or ready appropriately.
  6. Write a strong title and description.
  7. Address feedback in focused updates.
  8. Re-validate before merge.

© AlexAI-MCP, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/github-pr-workflow of AlexAI-MCP/hermes-CCC.

Open the folder on GitHubat commit 8107e89

Compare with similar skills

GitHub PR Workflow next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

GitHub PR Workflow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
GitHub PR Workflow this skillAlexAI-MCP/hermes-CCC135—~1.4kAutomated safety check: PassMIT
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Greplooponyx-dot-app/onyx32k4 repos~3.3kAutomated safety check: PassMIT
Check PRonyx-dot-app/onyx32k2 repos~2.3kAutomated safety check: PassMIT
Setup Matt Pocock Skillsbestofjs/bestofjs3.1k20 repos~1.7kAutomated safety check: PassMIT
Contributor-First PR MergeHKUDS/OpenHarness16k1 repos~847Automated safety check: PassMIT

Similar skills

  • PR Babysitter

    openinterpreter/openinterpreter

    Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.

    69k GitHub starsUsed in 3 repos~4.2k tokens
    DevelopmentAuto-check passed
  • Greploop

    onyx-dot-app/onyx

    Iteratively improves a PR (GitHub), MR (GitLab), or shelved changelist (Perforce) until Greptile gives it a 5/5 confidence score with zero unresolved comments.

    32k GitHub starsUsed in 4 repos~3.3k tokens
    DevelopmentAuto-check passed
  • Check PR

    onyx-dot-app/onyx

    Checks a GitHub, GitLab, or Perforce (p4) pull request (or merge request, or shelved changelist) for unresolved review comments, failing status checks, and incomplete PR descriptions.

    32k GitHub starsUsed in 2 repos~2.3k tokens
    DevelopmentAuto-check passed
  • Setup Matt Pocock Skills

    bestofjs/bestofjs

    Configure this repo for the engineering skills — set up its issue tracker, triage label vocabulary, and domain doc layout.

    3.1k GitHub starsUsed in 20 repos~1.7k tokens
    DevelopmentAuto-check passed
  • Merges external GitHub pull requests while keeping the original author credited, and fixes conflicts after the merge instead of rewriting the contribution.

    16k GitHub starsUsed in 1 repo~847 tokens
    DevelopmentAuto-check passed
  • Opens a GitHub pull request from your current branch with the gh CLI, after reviewing the commits and diff and gathering the details the PR needs.

    70k GitHub starsUsed in 1 repo~1.6k tokens
    DevelopmentAuto-check passed

More from AlexAI-MCP/hermes-CCC

All 44 skills in this repo
  • GitHub Code Review

    AlexAI-MCP/hermes-CCC

    Review GitHub pull requests with a findings-first engineering mindset.

    135 GitHub stars~1.3k tokensUpdated 6 mo ago
    Auto-check passed
  • Hermes Memory

    AlexAI-MCP/hermes-CCC

    Manage durable project memory for Claude Code. An agent skill from AlexAI-MCP/hermes-CCC.

    135 GitHub stars~1.7k tokensUpdated 6 mo ago
    Auto-check passed
  • Hermes Route

    AlexAI-MCP/hermes-CCC

    Route Claude Code work by complexity, risk, and tool needs. An agent skill from AlexAI-MCP/hermes-CCC.

    135 GitHub stars~1.9k tokensUpdated 6 mo ago
    Auto-check passed
  • Hermes Skill

    AlexAI-MCP/hermes-CCC

    Create, improve, inventory, and audit Claude Code skills. An agent skill from AlexAI-MCP/hermes-CCC.

    135 GitHub stars~1.7k tokensUpdated 6 mo ago
    Auto-check passed
  • Hermes Traj

    AlexAI-MCP/hermes-CCC

    Capture Claude Code interaction trajectories in training-friendly formats.

    135 GitHub stars~1.6k tokensUpdated 6 mo ago
    Auto-check passed
  • Subagent Driven Development

    AlexAI-MCP/hermes-CCC

    Decompose Claude Code work into parallel subagent-friendly streams when the environment permits delegation.

    135 GitHub stars~1.6k tokensUpdated 6 mo ago
    Auto-check passed

Works with

Categories

Questions about GitHub PR Workflow

What does GitHub PR Workflow do?

Run a disciplined GitHub pull request workflow from branch creation through merge. GitHub PR Workflow is an agent skill from AlexAI-MCP/hermes-CCC. Run a disciplined GitHub pull request workflow from branch creation through merge.

When should I use GitHub PR Workflow?

GitHub PR Workflow fits situations like: updating a PR after review; preparing review-ready diffs; managing draft versus ready states; landing changes with clear validation and risk notes.

How do I install GitHub PR Workflow in Claude Code?

Run `npx skills add AlexAI-MCP/hermes-CCC --skill github-pr-workflow -a claude-code`. Or copy the skill folder (skills/github-pr-workflow in AlexAI-MCP/hermes-CCC) into .claude/skills/github-pr-workflow in your project. Claude Code loads it when a task matches its description.

How do I install GitHub PR Workflow in Codex?

Run `npx skills add AlexAI-MCP/hermes-CCC --skill github-pr-workflow -a codex`. Or copy the skill folder (skills/github-pr-workflow in AlexAI-MCP/hermes-CCC) into .agents/skills/github-pr-workflow in your project. Codex loads it when a task matches its description.

Can I use GitHub PR Workflow in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add AlexAI-MCP/hermes-CCC --skill github-pr-workflow -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/github-pr-workflow, .gemini/skills/github-pr-workflow, .github/skills/github-pr-workflow and .opencode/skills/github-pr-workflow in your project.

What does GitHub PR Workflow need to run?

Going by SKILL.md and its folder, GitHub PR Workflow needs the command-line tools its instructions call (git and gh).

Does GitHub PR Workflow access the network?

SKILL.md contains no URLs. Its commands use git and gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is GitHub PR Workflow safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does GitHub PR Workflow use?

GitHub PR Workflow is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does GitHub PR Workflow use?

About 1.4k tokens (SKILL.md is roughly 5.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to GitHub PR Workflow?

Skills that share tags, products or a category with GitHub PR Workflow: PR Babysitter (openinterpreter/openinterpreter, 69k stars), Greploop (onyx-dot-app/onyx, 32k stars), Check PR (onyx-dot-app/onyx, 32k stars) and Setup Matt Pocock Skills (bestofjs/bestofjs, 3.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains GitHub PR Workflow?

AlexAI-MCP (a GitHub user) maintains it in AlexAI-MCP/hermes-CCC, which has 135 GitHub stars. The repository holds 44 skills in this directory. The repository was last updated on April 8, 2026.

Source: AlexAI-MCP/hermes-CCC on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.