clean-commits

Creates atomic, descriptive git commits following conventional commit message format.

Updated Jan 1, 2026
One-click install
npx skills add https://github.com/sarkarshivaditya-lab/WellMate --skill clean-commits-sarkarshivaditya-lab
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: clean-commits
Source: https://github.com/sarkarshivaditya-lab/WellMate/tree/main/.engineering-skills/troykelly-claude-skills/skills/clean-commits
Command: npx skills add https://github.com/sarkarshivaditya-lab/WellMate --skill clean-commits-sarkarshivaditya-lab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developers often create messy commit histories with vague messages, mixed changes, and broken intermediate states, making code review, debugging, and rollbacks painful. This Skill enforces atomic, well-described commits that keep the codebase in a working state at every point in history. ## Core Features & Use Cases - Conventional Commit Format: Structures messages with type prefixes (feat, fix, docs, refactor, test, chore), scope, and a 72-character summary, plus optional body and issue references. - Atomic Commit Enforcement: Guides splitting large changes into single logical units that pass tests and can be reverted cleanly. - Pre-Commit Verification: Requires tests, build, typecheck, and lint to pass before every commit. - Use Case: While implementing an authentication feature, you stage only the registration endpoint files and commit them as "feat(auth): Add user registration endpoint" with a body explaining the design, then separately commit the login endpoint, producing a reviewable, bisectable history. ## Quick Start Ask the AI to commit your current staged changes following clean-commits standards with a descriptive conventional commit message.

Frequently Asked Questions about clean-commits

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

FAQPage Schema
How do I write a good git commit message?▼

Use the conventional format: type(scope) followed by a summary under 72 characters, such as "fix(auth): Prevent redirect loop on expired session". Add a body explaining why the change was made, and reference the related issue with "Refs: #123".

How to split large changes into atomic commits?▼

Stage specific files for each logical unit separately using git add with explicit paths or git add -p for interactive staging. Commit each unit with its own message, ensuring tests pass after every commit.

What commit types should I use in conventional commits?▼

Use feat for new features, fix for bug fixes, docs for documentation, style for formatting, refactor for restructuring, test for test changes, and chore for maintenance or dependency updates.

When is it safe to amend a git commit?▼

Amend only commits that have not been pushed to a remote, typically to fix a typo or add a forgotten file. Never amend commits others have based work on; use git revert instead to undo shared changes.

Why should every commit leave the codebase working?▼

Working commits allow anyone to check out any point in history and run the code, which makes bisecting bugs, reverting changes, and reviewing pull requests reliable. Verify tests, build, typecheck, and lint pass before committing.