# commit-helper

> Claude/Codex skill by [@cockroachdb](https://omgskills.com/library/cockroachdb/index.md) · 33k stars · Updated 2026-10-21

Help create git commits and PRs with properly formatted messages and release notes following CockroachDB conventions. Use when committing changes or creating pull requests.

Tags: cockroachdb, database, distributed-database, go, hacktoberfest, sql

## Install

```sh
git clone https://github.com/cockroachdb/cockroach /tmp/cockroach && ln -s /tmp/cockroach/.claude/skills/commit-helper ~/.claude/skills/commit-helper
```

## From README

CockroachDB Commit Helper Help the user create properly formatted commit messages and release notes that follow CockroachDB conventions. Workflow Analyze the changes: Run git diff --staged or git diff to understand what was modified Determine the package prefix: Identify the primary package affected Ask the user for: Issue/epic number if not already known Whether release notes are needed and what category fits best Write the subject line: Imperative mood, no period, under 72 characters Write the body: Explain the before/after, why the change was needed Add issue references: Include Resolves/Epic as appropriate Write the release note: Clear, user-focused description of the change Create the commit using the properly formatted message Commit Message Structure Basic Format: Key Requirements: Must include release note annotation (even if "Release note: None") Must include issue or epic reference Must separate subject from body with blank line Recommended prefix subject with affected...

## Links

- HTML page: https://omgskills.com/skills/cockroachdb/cockroach/commit-helper/
- GitHub: https://github.com/cockroachdb/cockroach
- Author: [@cockroachdb](https://omgskills.com/library/cockroachdb/index.md)

## More skills by this author

- [cockroachdb-sql](https://omgskills.com/skills/cockroachdb/claude-plugin/skills/cockroachdb-query-and-schema-design/cockroachdb-sql/index.md) — Used when writing, generating, or optimizing SQL for CockroachDB, designing CockroachDB schemas, or when the user asks...
   - [@cockroachdb](https://omgskills.com/library/cockroachdb/index.md) · 4 stars
- [molt-fetch](https://omgskills.com/skills/cockroachdb/claude-plugin/skills/cockroachdb-onboarding-and-migrations/molt-fetch/index.md) — Guide for using molt fetch to migrate data from PostgreSQL, MySQL, Oracle, or MSSQL to CockroachDB.
   - [@cockroachdb](https://omgskills.com/library/cockroachdb/index.md) · 4 stars
- [molt-replicator](https://omgskills.com/skills/cockroachdb/claude-plugin/skills/cockroachdb-onboarding-and-migrations/molt-replicator/index.md) — Guide for using the CockroachDB replicator to continuously replicate changes from PostgreSQL, MySQL, or Oracle to...
   - [@cockroachdb](https://omgskills.com/library/cockroachdb/index.md) · 4 stars