smart-commit

Group working tree changes into atomic semantic commits with structured messages.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/JuantoC/BlueStack-Test-Automation-Framework --skill smart-commit-juantoc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: smart-commit
Source: https://github.com/JuantoC/BlueStack-Test-Automation-Framework/tree/main/.claude/skills/smart-commit
Command: npx skills add https://github.com/JuantoC/BlueStack-Test-Automation-Framework --skill smart-commit-juantoc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyzes the changes in the working tree, groups them semantically, and outputs atomic commits rich in business context ready to be consumed by commit-report. Activates when the user requests to generate commits and supports an optional --push flag to push at the end.

Core Features & Use Cases

  • Atomic, semantic commits for each logical change set, ready for review and integration.
  • Automatic generation of structured commit messages including type, module, title, and body aligned to business impact; ensures each commit remains revertible.
  • Optional push workflow: if --push is provided, pushes to the configured remotes after committing; integrates with the overall dev workflow to close the loop.

Quick Start

Analyze the current working tree by invoking the smart-commit command to generate semantic commits for your changes.

Frequently Asked Questions about smart-commit

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

FAQPage Schema
How do I generate semantic git commits with business context automatically?

Atomic commits are single, self-contained changes that group semantically related modifications, ensuring each commit remains independently revertible and rich in business context for easier review and integration.

What's the best way to group working tree changes into atomic commits?

The best way to group working tree changes into atomic commits is by analyzing the modifications, identifying logical change sets, and producing structured commit messages that align with business impact, feature work, refactors, and documentation updates.

Does smart-commit support pushing changes to remotes automatically?

Yes, smart-commit supports pushing changes to remotes automatically by providing the optional --push flag, which pushes the generated atomic commits to configured remotes after committing to close the development workflow loop.

Can I use semantic commit generation for refactoring and documentation updates?

Yes, you can use semantic commit generation for refactoring and documentation updates, as the workflow analyzes working tree changes across feature work, refactors, and docs to produce structured, atomic commits with appropriate business context.

Do I need a conventional project structure to generate structured commit messages?

Yes, you need a conventional project structure and git installed to identify logical change sets accurately and produce structured commit messages grouped by semantic relationships and business context.