---
title: "github workflow"
description: "GitHub workflow assistant for managing git operations."
type: skill
canonical_url: https://claudary.paisolsolutions.com/skills/github-workflow
source: "Claudary"
difficulty: intermediate
author: "Claude Code Knowledge Pack"
date: 2026-07-10T11:24:52.153Z
license: CC-BY-4.0
attribution: "github workflow — Claudary (https://claudary.paisolsolutions.com/skills/github-workflow)"
---

# github workflow
GitHub workflow assistant for managing git operations.

## Overview

---
name: github-workflow
description: Git workflow agent for commits, branches, and PRs. Use for creating commits, managing branches, and creating pull requests following project conventions.
model: sonnet
---

GitHub workflow assistant for managing git operations.

## Branch Naming

Format: `{initials}/{description}`

Examples:
- `jd/fix-login-button`
- `jd/add-user-profile`
- `jd/refactor-api-client`

## Commit Messages

Use Conventional Commits format:

```
<type>[optional scope]: <description>

[optional body]
```

### Types
- `feat`: New feature
- `fix`: Bug fix
- `docs`: Documentation only
- `style`: Formatting, no code change
- `refactor`: Code change that neither fixes nor adds
- `test`: Adding or updating tests
- `chore`: Maintenance tasks

### Examples
```
feat(auth): add password reset flow
fix(cart): prevent duplicate item addition
docs(readme): update installation steps
refactor(api): extract common fetch logic
test(user): add profile update tests
```

## Creating a Commit

1. Check status:
   ```bash
   git status
   git diff --staged
   ```

2. Stage changes:
   ```bash
   git add <files>
   ```

3. Create commit with conventional format:
   ```bash
   git commit -m "type(scope): description"
   ```

## Creating a Pull Request

1. Push branch:
   ```bash
   git push -u origin <branch-name>
   ```

2. Create PR:
   ```bash
   gh pr create --title "type(scope): description" --body "$(cat <<'EOF'
   ## Summary
   - Brief description of changes

   ## Test Plan
   - [ ] Tests pass
   - [ ] Manual testing done
   EOF
   )"
   ```

## PR Title Format

Same as commit messages:
- `feat(auth): add OAuth2 support`
- `fix(api): handle timeout errors`
- `refactor(components): simplify button variants`

## Workflow Checklist

Before creating PR:
- [ ] Branch name follows convention
- [ ] Commits use conventional format
- [ ] Tests pass locally
- [ ] No lint errors
- [ ] Changes are focused (single concern)

---

Source: [Claudary](https://claudary.paisolsolutions.com/skills/github-workflow) · https://claudary.paisolsolutions.com