Commit Helper 4

---
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

```
<type>: <summary>

[optional body]

[optional footer]
```

### Types

| Type | Use For |
|------|---------|
| `feat` | New feature |
| `fix` | Bug fix |
| `refactor` | Code restructuring (no behaviour change) |
| `test` | Adding/updating tests |
| `docs` | Documentation only |
| `chore` | Build, tooling, dependencies |

### Summary Rules

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

## Examples

**Simple:**
```
Add user authentication endpoint
```

**With body:**
```
Extract validation logic to separate module

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

**Breaking change:**
```
Change 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