OpenSkillIndex← back to search
claude-codedev

Gsd-skill-creator beautiful-commits

Crafts professional git commit messages following Conventional Commits. Use when committing changes or writing commit messages.

install
source · Clone the upstream repo
git clone https://github.com/Tibsfox/gsd-skill-creator
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/Tibsfox/gsd-skill-creator "$T" && mkdir -p ~/.claude/skills && cp -r "$T/examples/skills/dev/beautiful-commits" ~/.claude/skills/tibsfox-gsd-skill-creator-beautiful-commits && rm -rf "$T"
manifest: examples/skills/dev/beautiful-commits/SKILL.md
source content

Beautiful Git Commits

Format

<type>(<scope>): <subject>
<blank line>
<body>
<blank line>
<footer>

Rules

  • Subject: <72 chars (50 preferred), lowercase, imperative mood, no period
  • Imperative test: "If applied, this commit will [subject]"
  • Scope: Specific module/component in lowercase (auth, api, db, parser)
  • Body: Optional. Explain WHY/WHAT, not HOW. Wrap at 72 chars.
  • Footer: BREAKING CHANGE:, Fixes #N, Co-Authored-By:

Types

TypeUse
featNew feature
fixBug fix
docsDocumentation only
styleFormatting, no logic change
refactorNeither fix nor feature
perfPerformance improvement
testAdding/fixing tests
buildBuild system/dependencies
ciCI/CD config
choreOther maintenance

Atomic Commits

One logical change per commit. Split unrelated changes into separate commits.

Anti-Patterns

  • Vague subjects: "fix bug", "update stuff"
  • Past/present tense: "added", "adds" (use "add")
  • Multiple changes: "add login and fix navbar"
  • Implementation details: "change line 47"
  • Emotional language: "finally fixed!!!"