git-smart-commit

Analyzes git working directory changes and generates structured commit messages with dry-run confirmation.

7|Updated May 13, 2026
One-click install
npx skills add https://github.com/DawnMoon1542/agents-skills --skill git-smart-commit-dawnmoon1542
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-smart-commit
Source: https://github.com/DawnMoon1542/agents-skills/tree/main/git-smart-commit
Command: npx skills add https://github.com/DawnMoon1542/agents-skills --skill git-smart-commit-dawnmoon1542

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing consistent, well-structured commit messages requires manually reviewing diffs and deciding scope, type, and wording. This Skill automates that analysis while keeping you in control through a dry-run confirmation step before any commit is executed. ## Core Features & Use Cases - Scoped Change Analysis: Reads git status and diffs to determine which files belong in the commit, supporting task-context scoping, explicit path inclusion/exclusion, and split commits by file type. - Structured Commit Messages: Classifies changes into conventional types (feat, fix, refactor, test, chore, docs, style) and generates a typed subject plus a descriptive body. - Release Impact Review: Flags breaking changes, database schema changes, migration requirements, and announcements in a dedicated section before the commit message. - Safe Dry-Run Workflow: Shows branch, scope, file list, and the proposed message, then waits for confirm/edit/cancel before staging, committing, and optionally pushing. - Use Case: After finishing a bug fix, ask for a commit; the Skill inspects only the relevant files, proposes "fix: ..." with a body explaining the change, and commits only after your approval. ## Quick Start Ask the assistant to review my current git changes and create a smart commit with a dry-run preview before committing.

Frequently Asked Questions about git-smart-commit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a commit message automatically from git changes?

Invoke the smart commit flow and it runs git status and git diff on your working directory, classifies the changes, and proposes a typed commit message. You review the dry-run output and confirm before anything is committed.

How to commit only specific files or exclude tests from a commit?

State the scope explicitly, such as committing only src/auth changes or excluding test files. The Skill filters git status output by path patterns and analyzes only the in-scope diffs, listing excluded files separately in the dry-run.

Does it commit or push without my confirmation?

No. All analysis is read-only until you confirm the dry-run. After committing, it asks separately whether to run git push, and never pushes automatically.

What commit message format and types does it use?

It follows conventional commit types: feat, fix, refactor, test, chore, docs, and style. Mixed changes use the dominant type, with priority feat over fix over refactor when proportions are close, and BREAKING CHANGE only for actual external contract incompatibility.

What happens if a pre-commit hook fails during commit?

The commit stops and the hook output is displayed so you can fix the underlying issue. Empty commits are refused, and signing or credential failures prompt you to configure git user and credentials.