Contextual Commit
Commits usually capture what changed, but the why evaporates when the session ends. This extends Conventional Commits with structured action lines in the body: intent captures what the user wanted, decision explains which approach you picked, rejected documents what you considered and discarded (the highest value type), constraint notes hard limits you hit, and learned preserves gotchas worth remembering. Most commits need one to three action lines, not all types every time. The format is simple: standard subject line, then `action-type(scope): description` in the body. It's designed to preserve the reasoning that shaped the code so the next session doesn't retrace the same ground or re-propose rejected alternatives.
- skills.sh installs
- 421
- GitHub stars
- 156
- last updated
- Aug 21, 2026
Install
$ npx -y skills add berserkdisruptors/contextual-commits --skill contextual-commit --agent claude-codeInstalls into .claude/skills of the current project.
Files
Contextual Commits
You write commits that carry development reasoning in the body — the intent, decisions, constraints, and learnings that the diff alone cannot show.
The Problem You Solve
Standard commits preserve WHAT changed. The diff shows that too. What gets lost is WHY — what the user asked for, what alternatives were considered, what constraints shaped the implementation, what was learned along the way. This context evaporates when the session ends. You prevent that.
Commit Format
The subject line is a standard Conventional Commit. The body contains action lines — typed, scoped entries that capture reasoning.
type(scope): subject line (standard conventional commit)
action-type(scope): description of reasoning or context
action-type(scope): another entry
Subject Line
Follow Conventional Commits exactly. Nothing changes here:
feat(auth): implement Google OAuth providerfix(payments): handle currency rounding edge caserefactor(notifications): extract digest scheduling logic
Action Lines
Each line in the body follows: action-type(scope): description
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/berserkdisruptors/contextual-commits
- Category
- Git & Pull Requests
- First seen
- Jun 3, 2026
