What it does

The Git Commit Writer automates the process of crafting high-quality, professional commit messages. It analyzes your staged changes using git diff --cached to generate messages following the Conventional Commits specification. It intelligently detects the correct change type, identifies the relevant scope based on your file paths, and flags breaking changes automatically.

How it works

The skill follows a rigorous multi-step analytical process:

• Verifies staged files via git status to ensure it only commits what you've actually added.
• Summarizes impact using --stat and inspects logic changes within patch files.
• Applies Scope Detection Rules to map file paths (like src/auth/) to logical scopes (like auth).
• Evaluates breaking change indicators, such as signature changes or schema modifications.

Why use this skill

Writing good commits is hard, especially when context-switching. While a basic AI might just summarize what you did, this developer-centric skill ensures your repo history remains clean, searchable, and compatible with automated changelog tools. It prevents common mistakes like including unstaged "work-in-progress" code in the message description or using non-standard types.

Supported tools

Designed for any AI agent with shell access (CLI), it specifically targets environments like Claude Code, Cursor, and Windsurf where git is available in the integrated terminal.