/clean-commits

Turn messy WIP into clean, atomic commits with messages that explain why. Use before opening a PR.

BOOST

archive228@archive228

GitHub

From plugin

loopkit

75553 skills1 agent4 commands2 MCP

Install

$ npx -y skills add Archive228/loopkit --skill clean-commits --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.
You can call itInvoke it directly when you want it.
Slash command/clean-commits

Context preview

The summary Claude sees to decide when to auto-load this skill.

Turn messy WIP into clean, atomic commits with messages that explain why. Use before opening a PR.

SKILL.md

clean-commits.SKILL.md

name: clean-commits
description: Turn messy WIP into clean, atomic commits with messages that explain why. Use before opening a PR.
when_to_use: before a PR, messy history, "squash this", commit message help

Clean Commits

**Atomic** — one logical change per commit. Refactor and behavior change go in separate commits.
**Message** — subject says WHAT in imperative ("Fix null pointer in user lookup"), body says WHY. "Fix bug" is useless.
**Specific** — "Fix login failing when email has uppercase chars" tells the next person exactly what happened.
Reorder/squash WIP and "fix typo" commits into the real changes (`git rebase -i`).
Never mix an unrelated fix into a feature commit.

A good history is a debugging tool: `git bisect` and `git blame` only work if commits are atomic and messages explain intent.

Read it on GitHub ↗

Ships withloopkit

33 battle-tested skills + minimal .claude harness for any coding agent (Claude Code, Cursor, Codex, Gemini CLI).

Get the whole plugin

Stats

Node Bash SQL Git GitHub

+4 tags

Markdown Anthropic Gemini MCP

755

Stars

124