git-commit

Write conventional git commit messages with subject, body, and trailers.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/mattschwartz/systemos --skill git-commit-mattschwartz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-commit
Source: https://github.com/mattschwartz/systemos/tree/main/.claude/skills/git-commit
Command: npx skills add https://github.com/mattschwartz/systemos --skill git-commit-mattschwartz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writing clear, consistent git commit messages is essential for future readers to understand why changes were made and how they relate to the project history. This guide teaches a disciplined approach to formatting subjects, composing bodies, and applying trailers to attribute authorship.

Core Features & Use Cases

  • Subject line guidance: enforce the conventional format (type(scope): short description) with a clear, concise description.
  • Body guidance: explain the why, scope, and technical details when appropriate to provide context beyond the diff.
  • Trailers and collaboration: show how to include Co-authored-by and related task/PR references to acknowledge multiple contributors and link to discussions.
  • Use cases: consistent commits for features, fixes, refactors, and reviews that improve bisectability and changelog accuracy.

Quick Start

Draft a clear subject line and an informative body for your next commit.

Frequently Asked Questions about git-commit

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

FAQPage Schema
How do I write a conventional git commit message for a feature or bug fix?

To write a conventional git commit message, format the subject line as type(scope): short description, then use the body to explain why the change was made and what technical details were modified. This structure clarifies intent for features, fixes, and refactors.

What goes in the body of a git commit message?

The body of a git commit message should explain the why and scope of the change, providing technical context beyond the diff. Detailing why the modification was necessary helps future readers understand project history and improves bisectability.

How do I add a Co-authored-by trailer for shared git commits?

To add a Co-authored-by trailer for shared git commits, append the trailer at the end of the commit message body to attribute authorship to multiple contributors. This acknowledges collaboration and links shared work during pull request reviews.

What is the best way to format git commit subjects for pull request reviews?

The best way to format git commit subjects for pull request reviews is using the type(scope): description format. Keeping the subject concise and descriptive ensures changelog accuracy and communicates the commit intent clearly to reviewers.

When do I need to use conventional commit formats in version control workflows?

You need to use conventional commit formats in version control workflows whenever you want to improve changelog accuracy and bisectability. Applying structured subject, body, and trailer usage to feature work and bug fixes communicates intent to future readers.