---

name: Commit Helper description: Generate clear conventional commit messages from git diffs. Use when writing commit messages, reviewing staged changes, or after completing TDD cycles.

Commit Helper

This skill invokes the commit-helper agent to generate commit messages.

Quick Reference

Invoke: /commit-helper [options]

Options:

• No argument = analyse staged changes, return message
• --commit = generate message AND create commit

Conventional Commit Format

Copy<type>: <summary>

[optional body]

[optional footer]

Types

Summary Rules

• Under 50 characters
• Imperative mood ("add" not "added")
• No period at end

Examples

Simple:

CopyAdd user authentication endpoint

With body:

CopyExtract validation logic to separate module

Moved input validation from UserController to ValidationService
to improve testability and reuse across endpoints.

Breaking change:

CopyChange API response format

BREAKING CHANGE: responses now wrap data in `result` key

Agent Behaviour

The commit-helper agent:

1. Checks git status for staged changes
2. Reads staged diff
3. Checks recent commits for style consistency
4. Analyses change type and scope
5. Generates conventional commit message

Runs autonomously without user interaction.

Rules

• NEVER add contributors unless explicitly requested
• NEVER commit files containing secrets