# Git Commit

> Suggest commit messages based on staged changes and assist with committing using an editor. Use when this capability is needed.

- Skill: `tomevault-io/git-commit-3` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/git-commit-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/git-commit-3/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/git-commit-3

---

## Tasks

- Suggest commit messages based on staged changes in the current branch.

## Basic Steps

1) Get staged changes
    - Use the following command to get staged changes: `make git-diff-cached`
    - This command will:
        - Display the diff of staged changes (if any)
        - Show the next commit message file path to create (e.g., `_tmp/git-commit/0038.txt`)
        - Display "No staged changes to commit." if nothing is staged
2) Handle case when there are no staged changes
    - If there are no staged changes, ask the user if they want to stage all files.
    - Only if the user agrees, run the following to get the diff: `git add -A && make git-diff-cached`
3) Create new file `_tmp/git-commit/NNNN.txt` with commit message suggestions.
    - Use the file path shown by `make git-diff-cached` (e.g., `_tmp/git-commit/0038.txt`)
    - `NNNN` is a 4-digit zero-padded sequence number (e.g., `0001`, `0002`, ..., `0038`)
    - Suggest 3 commit message options.
    - Label each suggestion with `# Plan A/B/C` (see the example in the next section).
4) Commit with editor assistance.
    - Execute one of the following:
        - Task `Git: Commit with editor`
        - Terminal command `make git-commit-with-editor`
    - Run this step in the foreground (do NOT background it).
    - An editor will open for the user to edit the commit message file. Wait until the user closes the editor, which will complete the commit.
    - Do not proceed to the next step until the `git commit` process has exited.
5) Confirmation
    - Report the success or failure of `git commit`.
    - Run `make git-show` to check the latest commit message and confirm that one of Plan A/B/C is reflected. If it appears that the commit was made without selecting a plan, warn the user.

## Example of `_tmp/git-commit/NNNN.txt`

```
# Plan A
docs: git-commit skill and AGENTS.md improvements

- git-commit/SKILL.md: Organize steps in a bulleted list
- AGENTS.md: Clarify document structure

# Plan B
docs(dev): Project document structure maintenance
- .github/skills/git-commit/SKILL.md: Organize basic steps in a bulleted list and add confirmation step
- AGENTS.md: Clarify document classification for users and developers, specify placement of ADR/specs/tasks

# Plan C
docs: Document organization and skill step improvements
- git-commit/SKILL.md: Structure steps for better readability
- AGENTS.md: Clarify document placement rules
```

## Commit Message Guidelines

- Commit messages should be written in English.
- The title should be within 50 characters for English.
- Insert a blank line after the title.
- Use bullet points in the body to concisely explain the summary of changes.
- Add reasons based on past discussions with users (if possible).
- Follow Conventional Commits.
  - type: `feat | fix | refactor | perf | chore | docs | test`
  - Use directory names as scopes when necessary (e.g., `design/adr`).

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/kompox) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-14 -->