commit-work

Overview

Commit Work is a skill from the softaworks/agent-toolkit that helps create high-quality git commits by guiding developers through reviewing changes, staging intended files, splitting work into logical commits, and writing clear Conventional Commits messages. It provides a structured checklist workflow that ensures only intended changes are included and commits are easy to review.

Key Features

• 8-Step Commit Workflow - Structured checklist from inspecting the working tree through staging, reviewing, describing, writing messages, verification, and repeating for clean commits
• Conventional Commits Required - Enforces the type(scope): short summary format with body explaining what/why and optional BREAKING CHANGE footer
• Smart Split Decisions - Guides splitting commits by feature vs refactor, backend vs frontend, formatting vs logic, tests vs prod code, and dependency bumps vs behavior changes
• Safety Checks - Built-in sanity checks for secrets/tokens, accidental debug logging, and unrelated formatting churn before committing
• Patch Staging Support - Recommends git add -p for mixed changes within a single file, with git restore --staged -p for unstaging specific hunks

Who is this for?

This is for developers who want AI assistance in creating clean, well-structured git commits that follow Conventional Commits standards. It is ideal for teams that value atomic commits and want a systematic approach to reviewing, staging, and documenting their code changes.