conventional-commits

name	conventional-commits
description	Enforce, validate, lint, and manage Conventional Commits across git repositories. Generates semantic changelogs and installs git hooks.

Conventional Commits Skill

This skill enforces, validates, and manages Conventional Commits inside repositories.

Core Message Format

<type>[optional scope]: <description>

[optional body]

[optional footer(s)]

Types:

• feat: A new feature for the user.
• fix: A bug fix for the user.
• docs: Documentation changes.
• style: Formatting changes that do not affect code meaning.
• refactor: Code changes that neither fix a bug nor add a feature.
• perf: Code changes that improve performance.
• test: Adding or correcting tests.
• build: Changes affecting build systems or external dependencies.
• ci: Changes to CI configuration scripts.
• chore: General maintainence.
• revert: Reverts a previous commit.

Scripts Included

• scripts/commit-lint.sh: Checks if a commit message conforms to the Conventional Commits regex.
• scripts/install-git-hook.sh: Installs a commit-msg git hook into a target repository to automatically run the lint script on commit.
• scripts/generate-changelog.sh: Parses git history and generates grouped Changelogs.

Usage

Linting a commit message

To lint a message, pass the message text or a file containing the message:

<skill_dir>/scripts/commit-lint.sh "feat(auth): add email verification"

Installing the git hook in a repository

<skill_dir>/scripts/install-git-hook.sh /path/to/repository

Generating a Changelog

<skill_dir>/scripts/generate-changelog.sh HEAD~5..HEAD