---

name: Git Workflows description: This skill should be used when the user asks to "create a commit", "write commit message", "create a pull request", "generate changelog", "manage branches", "git workflow", "merge strategy", "PR description", or mentions git operations and version control workflows. version: 1.0.0

Git Workflows

Comprehensive git workflow skill for commits, pull requests, branching, and changelog generation.

---

Commit Message Format

Conventional Commits

Commit Types

Commit Analysis Workflow

1. Run git diff --staged to see changes
2. Identify change type (feat, fix, etc.)
3. Determine scope (affected component)
4. Write concise subject (< 50 chars)
5. Add body if context needed

---

Pull Request Structure

PR Template Elements

PR Analysis Workflow

1. List commits: git log main..HEAD --oneline
2. Identify themes across commits
3. Note any breaking changes
4. Check test coverage
5. Review documentation needs

---

Branch Strategies

Git Flow

GitHub Flow

Trunk-Based

Branch Naming

---

Changelog Format

Keep a Changelog Structure

Changelog Generation Workflow

1. Get commits since last release tag
2. Parse commit messages for type/scope
3. Group by category (Added, Fixed, etc.)
4. Format with links to issues/PRs

---

Best Practices

Commits

Pull Requests

Branches

---

Merge Strategies

Key concept: Squash for feature branches with messy commits. Rebase for clean linear history. Merge commit when branch history matters.

---

Common Git Commands

Pre-Commit

Commit

Branch Management

PR Workflow

Resources

• Conventional Commits: https://www.conventionalcommits.org/
• Keep a Changelog: https://keepachangelog.com/
• Git Book: https://git-scm.com/book