git-workflow

Git Workflow Skill

Expert patterns for Git version control workflows including branching strategies, commit conventions, collaborative workflows, and CI/CD integration.

🔌 Compatibility

This is an Agent Skill following the open standard originally developed by Anthropic and released for cross-platform use.

Supported Platforms:

• ✅ Claude Code (Anthropic)
• ✅ Cursor
• ✅ GitHub Copilot
• ✅ Other skills-compatible AI agents

Skills are portable packages of procedural knowledge that work across any AI agent supporting the Agent Skills specification.

Features

• Branching Strategies: Git Flow (feature/release/hotfix branches), GitHub Flow (simple feature branches), trunk-based development, release management patterns
• Commit Conventions: Conventional Commits standard, semantic versioning integration, commit message best practices, atomic commit patterns
• Collaborative Workflows: Pull request best practices, code review processes, merge strategies (merge, squash, rebase), conflict resolution patterns
• CI/CD Integration: GitHub Actions workflows, GitLab CI patterns, branch protection rules, automated versioning
• Git Hooks: Pre-commit hooks for linting and testing, commit message validation
• Advanced Operations: Interactive rebase, cherry-picking, stashing, reflog recovery

Installation

Marketplace (Recommended)

Add the Netresearch marketplace once, then browse and install skills:

# Claude Code
/plugin marketplace add netresearch/claude-code-marketplace

npx (skills.sh)

Install with any Agent Skills-compatible agent:

npx skills add https://github.com/netresearch/git-workflow-skill --skill git-workflow

Download Release

Download the latest release and extract to your agent's skills directory.

Git Clone

git clone https://github.com/netresearch/git-workflow-skill.git

Composer (PHP Projects)

composer require netresearch/git-workflow-skill

Requires netresearch/composer-agent-skill-plugin.

npm (Node Projects)

npm install --save-dev \
  @netresearch/agent-skill-coordinator \
  github:netresearch/git-workflow-skill

Requires @netresearch/agent-skill-coordinator, which discovers the skill in node_modules and registers it in AGENTS.md via a postinstall hook. For pnpm, also allowlist the coordinator's postinstall:

{
  "pnpm": {
    "onlyBuiltDependencies": ["@netresearch/agent-skill-coordinator"]
  }
}

Usage

This skill is automatically triggered when:

• Establishing branching strategies (Git Flow, GitHub Flow, Trunk-based)
• Implementing Conventional Commits for semantic versioning
• Configuring pull request workflows
• Integrating Git with CI/CD systems
• Setting up Git hooks for quality gates
• Resolving merge conflicts
• Configuring branch protection rules

Example queries:

• "Set up Git Flow workflow"
• "Configure conventional commits with semantic versioning"
• "Create GitHub Actions workflow for CI/CD"
• "Set up pre-commit hooks for linting"
• "Configure branch protection rules"
• "Implement pull request review process"

Structure

git-workflow-skill/
├── SKILL.md                              # Skill metadata and core patterns
├── references/
│   ├── branching-strategies.md           # Branch management patterns
│   ├── commit-conventions.md             # Commit message standards
│   ├── pull-request-workflow.md          # PR and review processes
│   ├── ci-cd-integration.md              # Automation patterns
│   └── advanced-git.md                   # Advanced Git operations
└── scripts/
    └── verify-git-workflow.sh            # Verification script

Expertise Areas

Branching Strategies

• Git Flow (feature/release/hotfix branches)
• GitHub Flow (simple feature branches)
• Trunk-based development
• Release management patterns

Commit Conventions

• Conventional Commits standard
• Semantic versioning integration
• Commit message best practices
• Atomic commit patterns

Collaborative Workflows

• Pull request best practices
• Code review processes
• Merge strategies (merge, squash, rebase)
• Conflict resolution patterns

CI/CD Integration

• GitHub Actions workflows
• GitLab CI patterns
• Branch protection rules
• Automated versioning

Conventional Commits Format

<type>[optional scope]: <description>

[optional body]

[optional footer(s)]