Skip to main content
subagent CX Codex

github-workflow — Claude Code subagent: what it does, how to install

github-workflow manages Git branches, Conventional Commits, and pull requests according to team conventions. Helpful for keeping repository history structured and tidy.

no license ★ 6,091 updated 2026-01-06

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/github-workflow.md
Open on GitHub

What github-workflow does

This subagent enforces repository conventions across daily Git actions. It runs on the sonnet model. Branches receive standard prefixes built from contributor initials followed by a task slug.

Before committing, the agent inspects modified files with git status and staged differences via git diff --staged. It categorizes commit messages using Conventional Commits prefixes such as feat, fix, docs, or refactor. PR titles follow the exact same structure to keep the changelog consistent.

Publishing a pull request triggers gh pr create prefilled with change summaries and a test plan checklist. Without the GitHub CLI installed and authenticated in your environment, PR generation will fail.

What it helps with

  • name Git branches using developer initials and task slugs
  • write Conventional Commits with standard type prefixes
  • generate pull requests via GitHub CLI with test plan checklists
  • verify diffs, local tests, and lint rules before pushing code

Example prompts for the agent

  • Create a new branch with my initials jd for the auth refactor
  • Commit staged changes following Conventional Commits format
  • Open a pull request for the login fix with a testing checklist

How to install github-workflow

Manually: put the files in place

.claude/agents/github-workflow.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about github-workflow

How do I install github-workflow in Claude Code?

Place the subagent definition file into your project at .claude/agents/github-workflow.md.

What does github-workflow do?

It guides routine Git operations like branch creation, staged diff inspections, and pull request generation. All commits and PR titles conform to Conventional Commits standards.

What prerequisites does github-workflow require?

The agent runs on the sonnet model. Creating pull requests directly from the terminal requires an active, authenticated gh command-line utility.

Similar subagents

All subagents for Git and GitHub →

From the same set11

The whole set →
onboard onboard — a command that prepares an agent to work on a project. It explores the codebase, asks clarifying questions, and records context for the next session. CX Codex +1 ★ 6,091repo stars pr-review pr-review inspects pull requests through the GitHub CLI against project standards and posts tiered review notes. CX Codex +1 ★ 6,091repo stars code-quality code-quality reviews TypeScript files in a chosen directory, runs npm checks, and groups findings by severity. Use it before a code change or review. CX Codex +1 ★ 6,091repo stars docs-sync docs-sync is a Claude Code command that compares documentation with recent code changes and flags inconsistencies. It catches outdated examples, incorrect API signatures, and mismatched parameter types. CX Codex +1 ★ 6,091repo stars ticket Handles the full ticket workflow: fetch task details from JIRA or Linear, explore related code, implement changes, and create a linked PR. Reduces manual sync between issue tracker and repository. CX Codex +1 ★ 6,091repo stars code-reviewer code-reviewer — a subagent for Claude Code that checks newly written or modified code against project standards, TypeScript strict mode, and security patterns. CX Codex ★ 6,091repo stars systematic-debugging systematic-debugging enforces a four-phase troubleshooting protocol rooted in root cause analysis. Ideal for tracking down broken test suites or runtime errors without trial-and-error edits. CX Codex +1 ★ 6,091repo stars graphql-schema The graphql-schema skill sets conventions for GraphQL queries, mutations, and type generation. It fits projects that use Apollo Client. CX Codex +1 ★ 6,091repo stars

More in the catalog

Project sponsors

Companies that keep this analytics open