Commitlint

Reference skill covering commitlint: rules, plugins, shareable configs, Git hook and CI integration.

What it does

This skill is a documentation reference for commitlint, the Conventional Commits message validation tool. It maps a user task to a category, then directs the agent to the relevant README and individual markdown pages covering rules configuration, plugins, shareable configs, the @commitlint/config-conventional preset, Husky/lefthook/simple-git-hooks integration, CI setup, custom rules, and the Node.js lint/load/read/format APIs. It also includes sample configurations and script pages for install, setup, CLI, validate, and prompt workflows.

When to use it

Use it when a task involves validating or configuring commit message conventions, such as setting up commitlint locally or in CI, writing custom rules or plugins, publishing a shareable config, or troubleshooting commitlint errors. It is also relevant when integrating commitlint with Git hooks or AI coding agents.

Requirements

The skill itself is documentation and needs no runtime beyond the agent's file-reading ability. The described commitlint tooling requires Node.js and npm packages such as commitlint and @commitlint/config-conventional, and Git hook managers (Husky, lefthook, simple-git-hooks) or CI runners for integration. It ships script pages under scripts/.