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 Updated 34 repo stars
Frontend Skills plugin card -- React/TypeScript skills, hooks, and agents for Claude Code and Codex

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 commit 83f12f602e

Frequently asked questions

npx get-skill add redpanda-data/setup-conventional-commits