atomic-semantics-commits

Generates atomic Git commit messages following a modified Conventional Commits specification.

Updated Nov 29, 2025
One-click install
npx skills add https://github.com/achyutkneupane/Blog-Kit --skill atomic-semantics-commits-achyutkneupane
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: atomic-semantics-commits
Source: https://github.com/achyutkneupane/Blog-Kit/tree/main/.ai/skills/atomic-semantics-commits
Command: npx skills add https://github.com/achyutkneupane/Blog-Kit --skill atomic-semantics-commits-achyutkneupane

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing consistent, meaningful Git commit messages is hard to enforce across a project, leading to vague titles, bundled changes, and unreadable history. This Skill enforces a strict commit format so every commit is atomic, traceable, and changelog-friendly. ## Core Features & Use Cases - Strict Type Prefixes: Restricts commits to a fixed set of types (feat, fix, refactor, perf, docs, test, chore, and more) with no scopes or sub-typing allowed. - Formatting Enforcement: Applies third-person present tense verbs, a 72-character title limit, no emojis, and mandatory blank-line separation between title and body. - Breaking Change Handling: Requires an explicit BREAKING CHANGE: note in the body when a commit introduces breaking changes. - Use Case: After staging changes for a new navigation feature, ask the assistant to write the commit message and receive a compliant message like feat: adds sub-navigation with context moved to the body. ## Quick Start Ask the assistant to write a commit message for your staged changes following the atomic semantic commit rules.

Frequently Asked Questions about atomic-semantics-commits

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

FAQPage Schema
How do I write a conventional commit message without scopes?▼

Use a type prefix followed by a colon and a third-person present tense verb, such as `feat: adds sub-navigation`. Never include scopes like `feat(ui):`, and keep the title under 72 characters with context moved to the body.

What commit types are allowed in Conventional Commits?▼

This skill allows feat, fix, improvements, perf, build, ci, refactor, docs, test, style, chore, and other. Each type maps to a specific change category, and alternative words like `feature` are not permitted.

How do I mark a breaking change in a commit message?▼

Include the exact phrase `BREAKING CHANGE:` in the commit body, followed by a space and an explanation of what breaks. The body must be separated from the title by a single blank line.

Why should commits be atomic in Git history?▼

Atomic commits isolate one logical change per commit, making history readable, reviews easier, and rollbacks safer. Bundling a bug fix with a new feature in one commit makes changes harder to trace and revert.

When should a commit message include a body?▼

Add a body only when extra context, reasoning, or explanation is truly necessary, such as explaining why a change was made. Simple changes like dependency bumps need only a title, for example `chore: bumps Laravel to v11.7.0`.