---
description: Write clear, focused Git commit messages and keep commits easy to review.
---

# Writing Git commits

Use this skill when preparing a commit.

1. Inspect the staged diff and identify the user-visible change.
2. Keep the subject concise, imperative, and specific.
3. Explain motivation and notable trade-offs in the body when needed.
4. Do not include generated files, credentials, or unrelated changes.
5. Verify the final staged diff before committing.