git-commit-practices

Enforce atomic, well-described commits with clear imperative messages.

9|2|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/DavidTeju/shared-skills --skill git-commit-practices-davidteju
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-commit-practices
Source: https://github.com/DavidTeju/shared-skills/tree/main/skills/git-commit-practices
Command: npx skills add https://github.com/DavidTeju/shared-skills --skill git-commit-practices-davidteju

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Claude tends to make poor commits: bundling unrelated changes, writing vague messages that reference external context, and committing working documents that shouldn't be version controlled.

Core Features & Use Cases

  • Atomic commits: ensure one logical change per commit to keep history clean and reversible.
  • Clear, self-explanatory messages: commit messages that describe what changed and why.
  • Safe scoping: avoid committing WIP or personal notes; separate concerns into focused commits.

Quick Start

Follow atomic commit practices by organizing changes into small, focused commits with clear messages before committing.

Frequently Asked Questions about git-commit-practices

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

FAQPage Schema
How do I make atomic commits with clear messages in git?

To make atomic commits, organize changes into small, focused commits with one logical change per commit and write clear, self-explanatory messages that describe what changed and why, keeping git history clean and reversible.

Why does git commit history get cluttered with unrelated changes?

Git commit history gets cluttered when changes are bundled together, vague messages reference external context, or working documents are committed. Enforcing atomic commits with well-described messages prevents bundling unrelated work and keeps history focused.

What is the best way to write git commit messages for feature development?

The best way to write git commit messages for feature development is to use clear, imperative messages that describe what changed and why. Self-explanatory messages ensure each atomic commit documents a single logical change without relying on external context.

Can I use atomic commit practices for refactoring across any codebase?

Yes, atomic commit practices apply to any codebase managed with git during feature development, bug fixes, or refactoring. Ensuring one logical change per commit with clear messages keeps version control history clean and reversible across all project types.

How do I avoid committing WIP documents and personal notes in git?

To avoid committing WIP documents and personal notes in git, enforce safe scoping practices that separate concerns into focused commits. Blocking working documents from version control ensures only meaningful, atomic changes are committed.

When should I not use atomic commits in version control?

You should always use atomic commits in version control for clean, reversible history. However, avoid using this approach when you need to bundle WIP documents or unrelated changes, as the practice blocks including non-version-controlled work.