git-workflow

Standardize Git commits, branches, and pull requests with Conventional Commits.

2|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/miptah21/skills --skill git-workflow-miptah21
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-workflow
Source: https://github.com/miptah21/skills/tree/main/.agents/skills/git-workflow
Command: npx skills add https://github.com/miptah21/skills --skill git-workflow-miptah21

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents messy commit history, inconsistent branching, and vague pull requests by standardizing how developers structure changes in Git.

Core Features & Use Cases

  • Commit Messages via Conventional Commits: Enforces a predictable <type>(<scope>): <description> format with clear rules for subject length and imperative mood.
  • Branch Naming Consistency: Uses a structured <type>/<short-description> pattern to make work purposefully searchable.
  • PR Communication Template + Merge Strategy: Guides PR titles, includes a reusable PR description structure (What/Why/How/Testing/Checklist), and recommends safer merge practices like squash for feature branches and rebase to keep branches up-to-date.

Quick Start

Ask your agent to prepare a commit message, branch name, and PR description following the git-workflow conventions for the changes you are about to submit.

Frequently Asked Questions about git-workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a conventional commit message for a feature update?

Conventional commits require a predictable format using a type, scope, and imperative description. This structure keeps the subject clear and limits length, making the change history readable and reviewable across collaborative repositories.

What should be included in a pull request description template?

A pull request description template should include What, Why, How, Testing, and Checklist sections. Providing testing evidence and context within the PR description ensures reviewers understand the changes and verifies safe merge practices.

What is the best way to name Git branches for bug fixes and chores?

The best way to name Git branches is using a structured pattern combining the type and a short description, like type/short-description. This deterministic naming convention makes work purposefully searchable for bug fixes, features, or CI maintenance.

Which merge strategy avoids force-pushes when updating feature branches?

A safe merge strategy that avoids force-pushes recommends using squash for feature branches and rebase to keep branches up-to-date. This approach standardizes release preparation and prevents messy commit history during collaborative work.

Does this Git workflow standardization work for documentation updates?

Yes, this Git workflow standardization applies to documentation updates, feature work, bug fixes, and CI maintenance. It enforces consistent commit, branch, and pull request conventions across any collaborative repository changes.