Meaning-first git commits. Plain language, one file at a time, readable by humans and machines. Use instead of raw git -- this skill enforces commit hygiene that makes history documentation. Use for every git operation. Never run raw git add, git commit, or git push -- always route through coherent-commit.
Meaning-first git commits. Plain language, one file at a time, readable by humans and machines.
Coherent Commit is a commit convention built for understanding. Every commit is a complete sentence. Every file gets its own commit. The history reads like a story.
Conventional Commits are machine-first -- structured prefixes (feat:, fix:, chore:) designed for changelogs, semver bumps, and CI triggers.
Coherent Commit is meaning-first -- plain language designed so anyone can open the commit history and follow what happened and why. Developers, managers, clients, AI agents -- all the same history, no translation needed.
This repo is an Agent Skill that any compatible AI agent can load. It enforces commit hygiene through seven operations:
| Operation | When to use |
|---|---|
| declare | Adding a new file |
| update | Changing an existing file |
| connect | Linking to an external system or dependency |
| checkpoint | Saving a named state you can return to |
| reset | Returning to the last checkpoint |
| commit-file | Staging and committing a single file |
| commit-plan | Walking through a list of files, committing each individually |
Every commit message is validated before it reaches git. Messages must be at least 24 characters, at least 5 words, no conventional commit prefixes, no placeholders like wip or update.
Copy or clone this repo into your project's .github/skills/ directory:
.github/skills/coherent-commit/
├── SKILL.md
└── scripts/
├── validate-message.sh
├── declare.sh
├── update.sh
├── connect.sh
├── checkpoint.sh
└── reset.sh
Any agent that supports the Agent Skills specification will discover it automatically.
For Claude Code specifically, you can also place it in .claude/skills/coherent-commit/.
The scripts work standalone. No agent required.
# Add a new file
scripts/declare.sh docs onboarding-guide.md "Add the onboarding guide so new hires have a single starting point"
# Update an existing file
scripts/update.sh docs/onboarding-guide.md "Update the onboarding guide to reflect the new three-step process"
# Save a checkpoint before something risky
scripts/checkpoint.sh "everything clean before the API refactor"
# Go back if it didn't work out
scripts/reset.sh
Messages are written for someone arriving with no context six months from now.
Good:
Add the Stripe integration spec so payment flows are documented in one placeUpdate the onboarding guide to reflect the new three-step processNever:
feat: add specupdate filewipThe validation script (scripts/validate-message.sh) enforces these rules and gives specific feedback when a message doesn't pass.
MIT. See LICENSE.
npx skills add CobraChickenAI/coherent-commit下载完整 Skill 目录，包含 SKILL.md 及所有相关文件
Search for places (restaurants, cafes, etc.) via Google Places API proxy on localhost.
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Start voice calls via the OpenClaw voice-call plugin.
Notion API for creating and managing pages, databases, and blocks.
Gemini CLI for one-shot Q&A, summaries, and generation.
Category:developer