← ClaudeAtlas

git-commitlisted

Git commit discipline — the Conventional Commits subject format, the 50/72 rule, and atomic single-purpose commits. Load when writing a commit message, committing an implementation slice, or preparing commits for a pull request.
bostonaholic/team · ★ 11 · Code & Development · score 75
Install: claude install-skill bostonaholic/team
# Git Commit Methodology A commit is the permanent record of a decision. A well-formed commit answers three questions: what changed, why it changed, and how to understand the change in isolation. Every commit should be correct on its own — readable without surrounding context, reversible without side effects, and meaningful in the project history. Write the prose this skill governs at a seventh-grade reading level, in STE-flavored mode — short sentences, common words, no unexplained jargon. Full methodology: `writing-prose`. Before you finalize prose this skill governs, call the Skill tool with `writing-prose` and apply its `## Self-lint` checklist. ## The 50/72 Rule ### Subject Line (50 characters) The subject line is what appears in `git log --oneline`, GitHub PR titles, and email notifications. Keep it under 50 characters. - **Imperative mood.** "Add user authentication" not "Added user authentication" or "Adds user authentication". Write as if completing the sentence "This commit will..." - **No period at the end.** The subject is a title, not a sentence. - **Capitalize the first word** (after the type prefix in Conventional Commits). - **Be specific.** "Fix bug" is not useful. "Fix null dereference in token parser" is useful. ### Body (72 characters per line) The body explains the *why*, not the *what*. The diff shows what changed. The body answers questions the diff cannot answer. - **Separate from subject with a blank line.** This is how git distinguishe