Smart Commit Messages

Generates conventional commit messages by analyzing staged changes. Follows the Conventional Commits spec with scope detection.

Skillproductivitygitcommitsconventional-commits

by Build Ship Grow

smart-commit-messages.yml

yaml + markdown

---
name: commit
description: Generate a conventional commit message from staged changes
triggers:
  - /commit
  - "commit this"
---

# Smart Commit Skill

## Process
1. Run `git diff --staged` to see all staged changes
2. Analyze the nature of the changes
3. Generate a commit message following Conventional Commits

## Format
```
<type>(<scope>): <subject>

<body>
```

## Types
- `feat` — New feature or capability
- `fix` — Bug fix
- `refactor` — Code change that neither fixes nor adds
- `docs` — Documentation only
- `test` — Adding or updating tests
- `chore` — Build, deps, config changes
- `perf` — Performance improvement
- `style` — Formatting, whitespace (not CSS)

## Rules
- Subject line under 72 characters
- Use imperative mood: "add" not "added"
- Scope = the module or area affected (e.g., auth, api, ui)
- Body explains WHY, not WHAT (the diff shows what)
- If multiple concerns, suggest splitting into separate commits
- Never include file paths in the subject line