GI

git-workflow

Assists with standard Git operations including commits, branching, and PR management.

Install

mkdir -p .claude/skills/git-workflow && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/975" && unzip -o skill.zip -d .claude/skills/git-workflow && rm skill.zip

Installs to .claude/skills/git-workflow

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Git workflow guidance for commits, branches, and pull requests
62 charsno explicit “when” trigger
Beginner

Key capabilities

  • Generate commit messages using a standardized type, scope, and subject format
  • Validate commit messages against predefined categories like feat, fix, and refactor
  • Enforce branch naming conventions using type, ticket ID, and description
  • Provide a structured Markdown template for pull request descriptions
  • Execute interactive staging and branch synchronization commands

How it works

The skill uses a specific Python script to generate and validate commit messages based on a defined template. It provides standardized command sequences for branching, staging, and rebasing to maintain repository consistency.

Inputs & outputs

You give it
Commit message content or branch task details
You get back
Formatted commit message string or branch name string

When to use git-workflow

  • Managing feature branches
  • Creating pull request descriptions
  • Resolving common commit workflow issues

About this skill

Git Workflow Skill

You are a Git workflow assistant. Help users with commits, branches, and pull requests following best practices.

Commit Message Guidelines

For commit message generation and validation, use get_skill_script("git-workflow", "commit_message.py").

Format

<type>(<scope>): <subject>

<body>

<footer>

Types

  • feat: New feature
  • fix: Bug fix
  • docs: Documentation only
  • style: Formatting, no code change
  • refactor: Code change that neither fixes a bug nor adds a feature
  • perf: Performance improvement
  • test: Adding or updating tests
  • chore: Maintenance tasks

Examples

feat(auth): add OAuth2 login support

Implemented OAuth2 authentication flow with Google and GitHub providers.
Added token refresh mechanism and session management.

Closes #123
fix(api): handle null response from external service

Added null check before processing response data to prevent
NullPointerException when external service returns empty response.

Fixes #456

Branch Naming

Format

<type>/<ticket-id>-<short-description>

Examples

  • feature/AUTH-123-oauth-login
  • fix/BUG-456-null-pointer
  • chore/TECH-789-update-deps

Pull Request Guidelines

Title

Follow commit message format for the title.

Description Template

## Summary
Brief description of what this PR does.

## Changes
- Change 1
- Change 2

## Testing
How was this tested?

## Checklist
- [ ] Tests added/updated
- [ ] Documentation updated
- [ ] No breaking changes

Common Commands

Starting Work

git checkout main
git pull origin main
git checkout -b feature/TICKET-123-description

Committing

git add -p  # Interactive staging
git commit -m "type(scope): description"

Updating Branch

git fetch origin
git rebase origin/main

Creating PR

git push -u origin feature/TICKET-123-description
# Then create PR on GitHub/GitLab

When not to use it

  • Projects that do not follow conventional commit standards
  • Environments where Git is not the primary version control system

Limitations

  • Requires manual execution of Git commands for branch creation and pushing
  • Limited to the specific commit types defined in the documentation

How it compares

This skill enforces a specific structural schema for commits and branches rather than relying on free-form text input.

Compared to similar skills

git-workflow side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
git-workflow (this skill)66moReviewBeginner
resolve-conflicts818moReviewIntermediate
dependency-upgrade265moReviewIntermediate
openspec-onboard106moReviewBeginner

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry