Skip to content

Tibsfox/gsd-skill-creator / examples/skills/dev/beautiful-commits

beautiful-commits

Verified

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

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!!!"
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall