git-atomic-commit
Installation
SKILL.md
Git Atomic Commit
Overview
This skill enables crafting clean, atomic git commits with conventional commit messages by analyzing all changes in the repository, intelligently grouping them into logical commits, and guiding the user through the process.
⚠️ Critical: Distinguish Commit Type vs. Commit Scope
Commit messages follow the pattern type(scope): subject. Type and Scope are governed by a three-tier hierarchy:
| Tier | What it governs | Defined by | Stability |
|---|---|---|---|
| 1. Universal | Standard Conventional Commits types | Industry convention | Fixed across all repos |
| 2. Author Preferences | Extended types + default file-path mappings | Skill author (opinionated) | Portable across repos; users may override |
| 3. Workspace-Specific | Scopes, additional types, file-path overrides | .github/git-scope-constitution.md per repo |
Unique per repository |
Commit Types = Tier 1 + Tier 2. Types represent the intent of the change. Commit Scopes = Tier 3. Scopes represent the domain, module, or location of the change, tightly coupled to the repository's context.