hook

conventional-commits — Claude Code hook: what it does, how to install

Q: How do I install conventional-commits in Claude Code?

Run `npx claude-code-templates@latest --hook git/conventional-commits`, then open `.claude/settings.json`.

Q: What does conventional-commits do?

It checks Git commit messages against `type(scope): description` and accepts the listed Conventional Commits types, including `feat`, `fix`, `docs`, and `revert`.

Q: What does conventional-commits require to run?

The hook calls `python3` to execute `.claude/hooks/conventional-commits.py`, so that interpreter must be available on the system.

This hook checks Git commit messages against the Conventional Commits pattern. Use it when commit history needs to support changelogs and semantic versioning.

Install into Claude Code · claude-code-templates All methods and platforms ↓

npx claude-code-templates@latest --hook git/conventional-commits

Open on GitHub

What conventional-commits does

The hook attaches to the PreToolUse event for Bash and runs .claude/hooks/conventional-commits.py. Before a commit is created, it checks the message against type(scope): description.

Accepted types are feat, fix, docs, style, refactor, perf, test, chore, ci, build, and revert. Keeping these labels consistent makes the Git history usable for changelog generation and semantic versioning. The check will not run without python3.

What it helps with

validate Git commit messages
enforce the type(scope): description pattern
reject unsupported commit types
keep history ready for changelogs and semantic versioning

Example prompts for the agent

Create a commit with the message feat(auth): add GitHub sign-in.
Commit the email validation fix as fix(forms): correct email checking.
Make a documentation commit using the docs type and a short description.

How to install conventional-commits

1claude-code-templates

npx claude-code-templates@latest --hook git/conventional-commits

2Manually: put the files in place

.claude/settings.json

The hooks block: event (PreToolUse, PostToolUse, Stop…) → command. Personal ones go to ~/.claude/settings.json

Step by step, with commands for each platform: Claude Code hooks: what they are, where to configure them, how to block a risky command

Questions about conventional-commits

How do I install conventional-commits in Claude Code?

Run npx claude-code-templates@latest --hook git/conventional-commits, then open .claude/settings.json.

What does conventional-commits do?

It checks Git commit messages against type(scope): description and accepts the listed Conventional Commits types, including feat, fix, docs, and revert.

What does conventional-commits require to run?

The hook calls python3 to execute .claude/hooks/conventional-commits.py, so that interpreter must be available on the system.

Source text

conventional-commits.json · MIT

{
  "description": "Enforce conventional commit message format for all git commits. Validates commit messages follow the pattern: type(scope): description. Supported types: feat, fix, docs, style, refactor, perf, test, chore, ci, build, revert. Ensures consistent commit history for changelog generation and semantic versioning.",
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "python3 \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/conventional-commits.py"
          }
        ]
      }
    ]
  }
}

Similar hooks

All hooks for Git and GitHub →

secrets-scanner official github Scans the files a Copilot coding agent touched during a session for leaked keys and credentials before they get committed. Useful when the agent edits code fast. ★ 40,451repo stars fix-broken-links official github This hook checks links in recently edited web files after GitHub Copilot uses a tool. It helps catch dead URLs and vague link labels before they linger in the project. ★ 40,451repo stars dependency-license-checker official github A GitHub Copilot hook that scans newly added dependencies at session end and flags copyleft licenses before they get committed. ★ 40,451repo stars

From the same set740

The whole set →

create-feature Builds a new feature scaffold with implementation guidance, tests, and docs. Use it when a feature needs a structured path from planning to review. 898installs create-onboarding-guide Scans your project repository to generate tailored onboarding documentation for new team members. It extracts stack details and workflows directly from config files. 835installs supabase-backup-manager A Claude slash command that runs Supabase database backups: takes snapshots, validates restores and manages the schedule. 812installs optimize-database-performance A Claude slash command that walks through slow queries, indexes and schema, then tells you what to rewrite. Useful when a page stalls on one SELECT. 794installs supabase-realtime-monitor Inspect Supabase Realtime connections, find subscription code in a project, and focus analysis on performance, errors, or connection status. 764installs setup-docker-containers Sets up Docker for development and production projects, covering multi-stage builds, Compose environments, and container workflows. 740installs doc-api Scans your codebase for endpoints and writes the API documentation: spec, request and response examples, an interactive page. Useful when there are too many routes to describe by hand. 733installs nextjs-performance-audit This command checks a Next.js project’s Lighthouse results, bundle size, and runtime performance. Use it to find performance issues and get optimization suggestions. 694installs