git-conventions

Define and enforce Git workflow conventions for branch naming, commit messages, and PR titles.

7|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/rloisell/rl-agents-n-skills --skill git-conventions-rloisell
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-conventions
Source: https://github.com/rloisell/rl-agents-n-skills/tree/main/git-conventions
Command: npx skills add https://github.com/rloisell/rl-agents-n-skills --skill git-conventions-rloisell

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enforces consistent Git practices across repositories, aligning branch naming, commit message formats, and conventional commit types to improve traceability and collaboration across teams.

Core Features & Use Cases

  • Standard Branch Naming: enforces pattern type/name for all branches (e.g., feat/login, fix/payment-bug).
  • Commit Message Format: enforces conventional commit structure with a short subject and optional body.
  • PR Title Guidelines: ensures descriptive, type-prefixed PR titles for easier review.
  • Automation Readiness: enables changelog generation and release notes from commit history.

Quick Start

Apply these conventions when creating branches, writing commits, or reviewing pull requests.

Frequently Asked Questions about git-conventions

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

FAQPage Schema
How do I standardize git commit messages and branch naming across my repositories?

Standardize git commit messages and branch naming by enforcing conventional commit structures and a type/name branch pattern. This establishes required formats, examples, and guardrails to ensure uniform version control practices across all team repositories.

What is the conventional commit format for pull request titles?

The conventional commit format for pull request titles requires a descriptive, type-prefixed structure. This ensures easier review by clearly indicating the nature of the changes, aligning PR discussions with overall workflow conventions.

How does enforcing conventional commits improve traceability and collaboration?

Enforcing conventional commits improves traceability by aligning commit types and branch names with a standardized format. This consistency enables automation readiness, allowing teams to generate changelogs and release notes directly from commit history.

Can I apply these git conventions to any repository workflow?

These git conventions apply specifically to rloisell/ and bcgov-c/ repositories. They establish standard branch naming, commit message formats, and PR discussion guidelines to enforce consistent Git workflows across those specific repository environments.

Do I need a specific branch naming pattern before writing conventional commit messages?

You need a type/name branch naming pattern, such as feat/login or fix/payment-bug, before writing conventional commit messages. This standardizes the workflow from branch creation through commit and pull request review.

What are the limitations of automating changelog generation from commit history?

Automating changelog generation from commit history requires strict adherence to conventional commit message formats and branch naming conventions. Without uniformity and quality in these version control practices, automated release notes and changelogs will be incomplete or inaccurate.