Skills for Real Engineers. Straight from my .agents directory.
gentle-ai-work-unit-commits
Agent skill fromGentleman-Programming/gentle-shell
Plan commits as reviewable work units. Trigger: implementation, commit splitting, chained PRs, or keeping tests and docs with code.
How to install gentle-ai-work-unit-commits
npx skills add Gentleman-Programming/gentle-shell# or add only this skill to Claude Code: copy the folder
skills/work-unit-commits/
# into
~/.claude/skills/work-unit-commits/ (all projects)
.claude/skills/work-unit-commits/ (one project)
1## When to Use23Load this skill when deciding what belongs in each commit or PR.45Use it for:67- Splitting a feature into reviewable work.8- Preparing commits before opening a PR.9- Turning a large change into chained or stacked PRs.10- Keeping reviewer cognitive load healthy.11- Committing ODD work in reviewable slices of about 400 authored changed lines.1213## Critical Rules1415| Rule | Requirement |16|------|-------------|17| Commit by work unit | A commit represents a deliverable behavior, fix, migration, or docs unit. |18| Do not commit by file type | Avoid `models`, then `services`, then `tests` if none works alone. |19| Keep tests with code | Tests belong in the same commit as the behavior they verify. |20| Keep docs with the user-visible change | Docs belong with the feature or workflow they explain. |21| Tell a story | A reviewer should understand why each commit exists from its diff and message. |22| Future PR-ready | Each commit should be a candidate chained PR when the change grows. |23| Delivery workload guard | If the task forecast produces a >400-line change, honor the selected `delivery_strategy`. On chaining paths only, group commits into chained PR slices before implementation. For explicit `single-pr` or `exception-ok`, keep one PR, report the review load, and follow the destination repository's documented contribution/size policy; selection alone does not accept an exception. |24…
Excerpt shown under the repository's MIT license.
More skills in gentle-shell
Similar skill repositories
An agentic skills framework & software development methodology that works.
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
Public repository for Agent Skills
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
An AI skill that provides design intelligence for building professional UI/UX across multiple platforms.
