active

Git Commit Formatter

Safe
System VerifiedSafe

Analyzes staged git changes and generates conventional commit messages. Auto-detects scope, enforces imperative mood, handles breaking changes.

@api/git-commit-formatter

git
commit
workflow
devtools

Git Commit Formatter

Purpose: Analyze staged changes and generate a properly formatted conventional commit message.


Invocation

code
/commit

Runs git diff --cached --stat and git diff --cached to analyze staged changes.


Conventional Commit Format

code
<type>(<scope>): <description>

[optional body]

[optional footer]

Types

TypeWhen to use
featNew feature or capability
fixBug fix
refactorCode restructuring without behavior change
testAdding or updating tests
docsDocumentation only
styleFormatting, whitespace, semicolons
perfPerformance improvement
ciCI/CD configuration
choreDependencies, tooling, config
buildBuild system or external dependency changes

Scope Detection

Infer scope from the changed files:

  • components/auth/*auth
  • api/skills/*skills-api
  • lib/utils/*utils
  • Multiple unrelated areas → omit scope

Description Rules

  • Imperative mood: "add" not "added" or "adds"
  • No period at the end
  • Under 72 characters
  • Focus on why, not what (the diff shows what)

Body Guidelines

Include a body when:

  • The change is not obvious from the description
  • Multiple files are modified for different reasons
  • Breaking changes need explanation

Format:

  • Wrap at 72 characters
  • Separate from subject with blank line
  • Use bullet points for multiple changes

Footer

  • BREAKING CHANGE: <description> — for breaking API changes
  • Closes #123 — for issue references
  • Co-Authored-By: Name <email> — for pair programming

Examples

Simple feature:

code
feat(auth): add GitHub OAuth login flow

Bug fix with context:

code
fix(api): prevent duplicate skill submissions

The content checksum was computed before sanitization,
allowing whitespace-only differences to bypass dedup.

Closes #47

Breaking change:

code
refactor(skills)!: rename focus_pool to engagement_score

BREAKING CHANGE: focus_pool column renamed to engagement_score.
Run migration 20260301 before deploying.
Dormant$0/mo

$20 more to next tier

Info

Created February 18, 2026
Version 1.0.0
User-invoked
Terminal output

Embed

Add this skill card to any webpage.

<iframe src="https://skillslap.com/skill/d11ca9ac-f506-41ce-b2d6-69c9408f9b6f/embed"
        width="400" height="200"
        style="border:none;border-radius:12px;"
        title="SkillSlap Skill: Git Commit Formatter">
</iframe>