Profile My skills Saved Collections Edit profile Submit a skill

Setup Conventional Commits

Enforce conventional commit format via a PreToolUse hook on Bash that intercepts git commit commands. Replaces commitlint + husky entirely. Use when setting up conventional commits, commit message validation, or enforcing commit format standards.

redpanda-data 83f12f6 4 files · 5.2 KB Updated 6 repo stars
Coding & Dev Tools

File contents

Setup Conventional Commits

PreToolUse hook (Bash) intercept git commit -m -> validate format. Replace commitlint + husky (zero deps).

Format

type(scope): description
  • type: feat|fix|refactor|style|test|docs|chore|perf|ci|build|revert
  • scope: required, lowercase in parens -- feat(webui):, fix(backend):
  • description: lowercase first letter, no trailing period, 5-72 chars
  • body: optional, encourage feat/fix

Steps

  1. Copy scripts/conventional-commits-check.sh + scripts/_hook-lib.sh -> .claude/hooks/. chmod +x.
  2. Add to .claude/settings.json: PreToolUse (Bash): .claude/hooks/conventional-commits-check.sh
  3. Optional: codex-compat for Codex .codex/hooks.json

Verify

  • Block: git commit -m "bad message", git commit -m "feat: missing scope", git commit -m "feat(ui): A" (uppercase)
  • Allow: git commit -m "feat(ui): add button component"
  • Ignore non-commit Bash commands

redpanda-data/ui-harness/tree/main/setup-conventional-commits commit 83f12f602e

Browse category

Frequently asked questions

npx skillmds@latest add redpanda-data/setup-conventional-commits