Skip to content
Get packs

Work-Unit Commit Planner

Plans git commits and PRs as small, reviewable units with tests and docs included

Source Download skill
Repository
Gentleman-Programming/gentle-ai
Stars
8,181
Licence
MIT
Files
1 file

What it does

When installed, the agent plans how to split code changes into commits and pull requests that each deliver one clear piece of behavior, fix, or doc update, instead of grouping by file type. It keeps tests and docs with the code they cover, aims to keep PRs under about 400 changed lines by splitting large work into chained PRs, and writes Conventional Commit messages that describe outcomes. It also suggests running git diff and git log commands to review the change before committing.

Great for

  • Developers preparing commits or PRs from a large feature or refactor
  • Teams that want reviewable, stacked or chained PRs with tests included
  • Anyone using the SDD or ODD workflows described in the file who needs commit-splitting guidance

Skip it if

  • Quick one-line fixes where splitting into work units adds overhead
  • Projects with different commit conventions, since the skill assumes Conventional Commits and a 400-line guideline
  • Non-developers who do not use git, as the guidance is specific to git history and PR review

Try asking

  • “Split this feature branch into reviewable commits, each with its tests”
  • “Plan chained PRs for this 900-line change, keeping each under about 400 changed lines”
  • “Review my staged changes and suggest a commit message that explains the outcome”
  • “Check whether my recent commits follow a work-unit style before I open a PR”
Step-by-step guide: how to use Work-Unit Commit PlannerInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    work-unit-commits.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip work-unit-commits.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip work-unit-commits.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Ask the agent to inspect git diff --stat before committing so it can group changes by behavior.
  • Mention your project's own commit or PR size conventions, since the 400-line threshold and Conventional Commit style come from this skill's rules.
  • Expect the agent to ask for focused test commands and rollback notes; supply them to get complete commit plans.

What's inside

  • SKILL.md

Redistributed unmodified from Gentleman-Programming/gentle-ai under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.