work-unit-commits

Gentleman-Programming8.8kstars

Plan commits as reviewable work units. Trigger: implementation, commit splitting, chained PRs, or keeping tests and docs with code.

Developer ToolsKnowledge Memory

Install GitHub

1---2name: work-unit-commits3description: Plan commits as reviewable work units. Trigger: implementation, commit splitting, chained PRs, or keeping…4---56# internal/assets/skills/work-unit-commits/SKILL.md

SKILL.mdAgent skill

Transport: File
Status: Listed

SKILL.md

Install

The skill file stays in the publisher's repository.

Paste the copied command in a terminal. It installs this SKILL.md into that agent.

shterminal

1npx skills add Gentleman-Programming/gentle-ai --skill work-unit-commits -a cursor -y

Paste the copied command in a terminal. It installs this SKILL.md into that agent.

shterminal

1npx skills add Gentleman-Programming/gentle-ai --skill work-unit-commits -a claude-code -y

Paste the copied command in a terminal. It installs this SKILL.md into that agent.

shterminal

1npx skills add Gentleman-Programming/gentle-ai --skill work-unit-commits -a codex -y

Paste the copied command in a terminal. It installs this SKILL.md into that agent.

shterminal

1npx skills add Gentleman-Programming/gentle-ai --skill work-unit-commits -a grok -y

Send the copied message in a Grok Bot chat. The Bot fetches this SKILL.md from GitHub and adds it to the skills all your Bots share.

txtGrok Bot chat

1Install this skill: https://github.com/Gentleman-Programming/gentle-ai/tree/HEAD/internal/assets/skills/work-unit-commits

Download skill internal/assets/skills/work-unit-commits/SKILL.md on GitHub

internal/assets/skills/work-unit-commits/SKILL.mdMarkdown · UTF-8

Skill facts

Agent skill

File: internal/assets/skills/work-unit-commits/SKILL.md
Publisher: Gentleman-Programming
Hosting

FAQ

Questions

name: work-unit-commits
description: Plan commits as reviewable work units. Trigger: implementation, commit splitting, chained PRs, or keeping tests and docs with code.
license: Apache-2.0
metadata: author: gentleman-programming version: "1.0"

When to Use

Load this skill when deciding what belongs in each commit or PR.

Use it for:

Splitting a feature into reviewable work.
Preparing commits before opening a PR.
Turning a large change into chained or stacked PRs.
Keeping reviewer cognitive load healthy.
Committing ODD work units in reviewable slices.

Critical Rules

Rule	Requirement
Commit by work unit	A commit represents a deliverable behavior, fix, migration, or docs unit.
Do not commit by file type	Avoid `models`, then `services`, then `tests` if none works alone.
Keep tests with code	Tests belong in the same commit as the behavior they verify.
Keep docs with the user-visible change	Docs belong with the feature or workflow they explain.
Tell a story	A reviewer should understand why each commit exists from its diff and message.
Future PR-ready	Each commit should be a candidate chained PR when the change grows.
Budget is not code-golf	Never shrink a diff by deleting comments, blank lines, docs, or tests, or by compressing code, to fit the review budget (400 by default, or the session `review_budget_lines`). Slice by work unit or report the overage.

Work Unit Checklist

Before committing, confirm:

The commit has one clear purpose.
The repo still makes sense after applying only this commit.
Tests or docs for this unit are included when relevant.
Rollback is reasonable without reverting unrelated work.
Focused test command and exact result are recorded.

Weak split	Better work-unit split
`add models`	`feat(auth): add token validation domain model and tests`
`add services`	`feat(auth): wire token validation into login flow`
`add tests`	Tests included with each behavior commit
`update docs`	Docs included with the user-facing change they explain

work-unit-commits

Install

Skill facts

Questions

How do I install work-unit-commits?

Where does work-unit-commits live?

Which agents can use work-unit-commits?

SKILL.md

When to Use

Critical Rules

Work Unit Checklist

Split Examples

PR Relationship

ODD Relationship

Commands