commit-helper

Installation
SKILL.md

CockroachDB Commit Helper

Help the user create properly formatted commit messages and release notes that follow CockroachDB conventions.

Workflow

  1. Analyze the changes: Run git diff --staged or git diff to understand what was modified
  2. Determine the package prefix: Identify the primary package affected
  3. Ask the user for:
    • Issue/epic number if not already known
    • Whether release notes are needed and what category fits best
  4. Write the subject line: Imperative mood, no period, under 72 characters
  5. Write the body: Explain the before/after, why the change was needed
  6. Add issue references: Include Resolves/Epic as appropriate
  7. Write the release note: Clear, user-focused description of the change
  8. Create the commit using the properly formatted message

Commit Message Structure

Related skills
Installs
501
GitHub Stars
32.1K
First Seen
Jan 21, 2026