commit-forge

Create atomic git commits following the conventional format.

12|2|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/alxxpersonal/forge --skill commit-forge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: commit-forge
Source: https://github.com/alxxpersonal/forge/tree/main/skills/commit-forge
Command: npx skills add https://github.com/alxxpersonal/forge --skill commit-forge

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ensures that git history remains clean and understandable by enforcing atomic, descriptive commits that reflect a single logical change, reducing review time and confusion.

Core Features & Use Cases

  • One commit per logical change, with a clear, conventional format (type(scope): description).
  • Support for common commit types (feat, fix, docs, refactor, test, chore, style, perf) and the use of a short scope.
  • Guardrails to prevent risky actions like co-author tagging or skipping hooks, promoting deliberate, reviewed commits.

Quick Start

Create a single, atomic commit describing the latest change in the repository.

Frequently Asked Questions about commit-forge

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

FAQPage Schema
How do I automate atomic git commits with conventional formats?

To automate atomic git commits, this tool enforces a one-change-per-commit rule and standardizes the subject, body, and footer structure using conventional types like feat, fix, and docs to maintain a clean version-control history.

What is an atomic commit and when do I need it in version control?

An atomic commit represents a single logical change in your version-control history. You need it to keep git history understandable, which reduces review time and prevents confusion when tracking specific features or fixes.

How do I format git commit messages using conventional commits best practices?

Formatting conventional commit messages requires a type(scope): description structure. This tool supports common types like feat, fix, refactor, and chore, while applying guardrails to block risky flags and ensure a standardized subject, body, and footer.

Can I use co-author tags or skip git hooks when creating commits?

No, you cannot use co-author tags or skip git hooks. This enforces guardrails that block co-author tagging and risky flags to promote deliberate, reviewed commits and maintain strict version-control best practices.

What is the best way to enforce a one-change-per-commit rule in git?

The best way to enforce a one-change-per-commit rule is to automate the staging and commit process with strict guardrails. This tool prevents risky actions and requires a conventional commit format, ensuring each commit reflects a single logical change.

Do I need to stage changes before automating conventional commits?

Yes, you need to stage changes first. This applies to developers who stage changes or complete tasks, taking those staged changes and formatting them into a clean, atomic conventional commit with a standardized structure.