atomic-commits

What problem does it solve?

Large, messy, or unrelated commits hinder code review, make debugging difficult, and complicate Git history. This Skill guides you in creating clean, atomic commits that are easy to understand and revert.

Core Features & Use Cases

• Reviewable Commits: Principles for creating commits that are atomic, buildable, testable, and easily revertable.
• Commit Decision Matrix: Guidance on when to commit immediately, group tasks, or split changes into separate commits.
• Commit Size Guidelines: Recommendations for ideal line changes (50-200 lines) and warnings for oversized commits.
• Commit Message Format: Integrate task references into conventional commit messages for clear traceability.
• Use Case: Decide whether to commit a task immediately or group it with a related one, structure commits for a new feature, or clean up a messy Git history.

Quick Start

Explain why a commit that adds a new feature and fixes an unrelated CSS bug should be split into two separate commits.