Skip to main content
skill CX Codex

git-commit · microsoft — Claude Code skill: what it does, how to install

git-commit walks through confirming which paths to stage, then makes one local Conventional Commit, or just drafts a commit message for changes already staged.

MIT ★ 1,627 updated 2026-10-25

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add microsoft/hve-core --skill git-commit -a claude-code
Open on GitHub

What git-commit does

The skill first inventories tracked, untracked and deleted paths with git status --porcelain=v1 -z --untracked-files=all, then asks the user to confirm whole paths before anything is staged, instead of letting partial hunks slip in. After staging, it re-checks the index through the host's staged-changes tool (get_changed_files) to make sure only the confirmed paths landed there, and only then writes the commit via git commit -F -.

If a file has both staged and unstaged edits, the skill stops and leaves that path for the user to sort out by hand rather than guessing at intent. Commit text itself follows a separate set of commit-message rules covering type, scope and the footer line.

Run it with mode=message-only and it reads whatever is already staged via git --no-pager diff --staged and prints a ready message in a code block, without touching the index or creating a commit.

What it helps with

  • build one Conventional Commit from manually chosen files
  • draft a commit message for changes already staged
  • verify the exact staged path set before committing
  • undo accidental staging without losing other pending work
  • edit or soft-reset the last commit's message

Example prompts for the agent

  • Commit the changes in src/api.py and README.md
  • Generate a commit message for the staged changes, mode=message-only
  • Undo the last commit but keep the changes staged

How to install git-commit

1Skills CLI (Vercel)

npx skills add microsoft/hve-core --skill git-commit -a claude-code

2Manually: put the files in place

~/.claude/skills/git-commit/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/git-commit/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about git-commit

How do I install git-commit in Claude Code?

Run npx skills add microsoft/hve-core --skill git-commit -a claude-code; the skill lands at ~/.claude/skills/git-commit/SKILL.md.

What does git-commit do?

It stages only the paths a user has explicitly confirmed, re-verifies the exact staged set, and creates one local Conventional Commit, or drafts a message for changes that are already staged without committing.

What happens if a file has mixed staged and unstaged changes?

The skill stops and asks the user to resolve that file's hunks outside the workflow; it never unstages or partially restages a path on its own.

Source text

SKILL.md · MIT
---
name: git-commit
description: 'Stage user-selected paths, confirm the exact staged set, and create one local Conventional Commit, or generate a commit message for staged changes without committing. Use when you want a guarded commit or a ready-to-paste message.'
argument-hint: '[mode={commit|message-only}]'
license: MIT
user-invocable: true
disable-model-invocation: true
---
<!-- cspell:ignore pathspecs unstages -->

# Git Commit

## Goal

Create one local Conventional Commit from whole paths the user selects and confirms, or generate a message for the currently staged changes without touching the index.

## Inputs

* `mode` (optional): `commit` (default) runs the select, stage, confirm, and commit protocol. `message-only` generates a message for the staged changes and never stages, unstages, or commits.

## Message Rules

Generate every message by following the `commit-message` instructions. They own types, scopes, description and body limits, and the footer line. Once generated, the message is authoritative for the commit.

## Message-Only Mode

1. Read the staged changes with `git --no-pager diff --staged`. Use the host's staged-changes tool instead when the user asks to avoid the terminal or no terminal is available.
2. When nothing is staged, output `No changes to commit.` and stop.
3. Generate the message from the complete staged diff.
4. Output the message in a fenced code block and tell the user to copy it as-is or edit it before committing.

## Commit Protocol

1. Inventory candidate paths. Before changing the index, run `git status --porcelain=v1 -z --untracked-files=all` and `git rev-parse --verify HEAD` in the target repository.
   * Record tracked, untracked, deleted, renamed, copied, and initially staged paths. Treat only an `R` or `C` status record that supplies both old and new paths as one logical selection. Present a separate deletion and untracked addition as independent candidates without inferring a rename.
   * If `HEAD` cannot be verified, stop, because this workflow cannot restore a rejected staging change safely.
   * If any path has both staged and unstaged changes, stop and ask the user to resolve its hunk-level intent outside this workflow. Do not restage a partially staged path.
   * If there are no candidate changes, output `No changes to commit.` and stop.
2. Confirm whole-path intent. Present the candidate paths and their states without file contents, then ask the user to select the whole paths intended for this commit.
   * Every initially staged path must be selected. If the user excludes one, stop before changing the index; never unstage prior user work.
   * A status-reported rename or copy is selected only as its complete old-and-new path pair.
   * If the selection is empty, ambiguous, unsafe to represent as shell arguments, or absent, stop without staging or committing.
3. Stage only the selection with `git --literal-pathspecs add -- <safely quoted selected paths>`. Never use an unscoped `git add -A` or `git add -u` path.
   * Quote each path for the active shell and keep `--` before path arguments. If a path cannot be represented safely, stop.
   * Record only the selected paths that were not initially staged as this invocation's staging delta.
   * If staging fails, report a concise error and stop without retrying.
4. Inspect and confirm the staged set. Use the host's staged-changes tool, such as `get_changed_files` with `sourceControlState` set to `staged` and `repositoryPath` set to the full project path.
   * Verify that the exact staged path set contains every selected path, contains every initially staged path, and contains no unselected path. If it differs, restore this invocation's staging delta and stop.
   * Present the exact staged paths without file contents or suspected sensitive values. Ask the user to confirm that these paths and their staged content are intended for the local commit.
   * If the user rejects, does not respond, or gives an ambiguous answer, restore this invocation's staging delta and stop without committing.
   * If no staged changes remain, output `No changes to commit.` and stop without creating an empty commit.
5. Generate the message from the staged changes and commit once, without showing the message first.
   * Pipe the exact message, including body and footer line, through STDIN, for example `echo "<full message>" | git commit -F -`. Preserve newlines exactly and end with the footer line followed by a newline.
   * Run no other Git command at this step (no push, pull, fetch, diff, show, status, log, branch, switch, merge, rebase, or tag).
6. After the commit succeeds, print `Commit created successfully with the following message:`, a blank line, and the full message in a fenced `markdown` code block.
7. If the commit fails, for example because a hook rejects it, report a concise error with a suggested fix and stop without retrying.

### Staging-Delta Restoration

* Restore only paths newly staged by this invocation with `git --literal-pathspecs reset -- <safely quoted staging-delta paths>`. This resets their index entries to `HEAD`, preserves working-tree content, and leaves initially staged paths unchanged.
* Treat both paths of a selected status-reported rename or copy as one restoration unit.
* If restoration fails, report the affected path names and stop. Do not retry or run another recovery command.

### Allowed Commands

* Normal flow: `git status --porcelain=v1 -z --untracked-files=all`, `git rev-parse --verify HEAD`, path-scoped `git --literal-pathspecs add -- <paths>`, path-scoped `git --literal-pathspecs reset -- <paths>` for staging-delta restoration only, and `git commit -F -` or a single-line `git commit -m`.
* Adjustment flow: `git reset --soft HEAD^` as defined in Post-Commit Adjustments.
* Never use Git CLI to obtain file contents or diffs in commit mode. Use `git status` only for path and index-state metadata, and rely on the staged-changes tool for staged content.
* Never use root `.gitignore` presence, absence, length, or completeness as staging authorization.
* Never add a pre-commit hook, require a secret-scanner dependency, or claim that this workflow performs deterministic secret detection. Repository-owned scanning remains a separate downstream control.

## Post-Commit Adjustments

Start this flow only when, immediately after the commit is displayed, the user explicitly asks to change its message or to undo it.

1. Treat the commit just created in this session as the target; do not run history commands to confirm it.
2. Run `git reset --soft HEAD^` to uncommit while preserving the index and working tree.
3. For an undo without a new message, print `Commit undone (changes staged, no new commit message requested).` and stop without committing.
4. For a message change, merge the requested edits into the previous message, correct anything that breaks the commit-message instructions, and commit again with `git commit -F -`.
5. Print `Commit message updated successfully:`, a blank line, and the updated message in a fenced `markdown` code block.

Constraints for this flow:

* Use one soft reset per commit created; repeat only after the user acknowledges the previous update.
* Never amend, rebase, or use the reflog, and never change file contents; only the message changes.
* Keep the original type and scope unless the user supplies valid replacements, and keep exactly one footer line last.
* If the reset or the new commit fails, report a concise error and stop.

## Success Criteria

* Wait only for the two required user decisions: whole-path selection before staging and exact staged-set confirmation before commit. Never infer either decision from silence.
* Only selected paths and initially staged paths enter the commit, and a rejected staged set leaves the initial index and working tree unchanged.
* Message-only mode leaves the index untouched.
* No push or remote operation occurs.

## Example Output

````markdown
Commit created successfully with the following message:

```markdown
feat(prompts): update work item prompts to clarify json output

🔒 - Generated by Copilot
```
````

© microsoft · MIT · microsoft/hve-core

Similar skills

All skills for Git and GitHub →

git-commit by other authors comes first.

git-commit official github A GitHub Copilot skill that turns a working diff into a commit: it reads the changes, stages the related files, writes a Conventional Commits message and runs git commit. CX Codex +1 47,165installs git-commit decebals git-commit generates Conventional Commits messages for Java codebases based on staged changes inspected with git diff. CX Codex +1 264installs git-commit fvadicamo Writes git commits in Conventional Commits format with a type, a required scope and a short subject. Useful when the agent commits on your behalf. CX Codex +1 324installs git-commit ThinkInAIXYZ git-commit generates commit messages following Conventional Commits — type, scope, and subject. The agent reads staged changes via git diff --staged and proposes a message. CX Codex +1 1installs git-commit ilteoood git-commit — a skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode that reads the diff and builds a Conventional Commits message automatically. CX Codex +1 624installs git-commit-helper davila7 Reads git diff --staged and drafts a commit message following Conventional Commits. It fires after every Bash tool call and appends a line to ~/.claude/git-commit-helper.log. CX Codex +1 7,093installs create_git_diff_commit danielmiessler create_git_diff_commit generates git add and git commit commands from a repository diff using Conventional Commits. GP ChatGPT ★ 44,690repo stars commit getsentry Drafts Sentry-style conventional commits with issue references and blocks direct commits to main. CX Codex +1 4,900installs ce-commit EveryInc ce-commit is a Claude Code skill that automatically creates git commits with meaningful messages. It splits staged or unstaged changes into logical groups without pushing. CX Codex +1 3,600installs conventional-commit marcelorodrigo Makes AI coding agents write commits to the Conventional Commits spec: type, scope, imperative subject. CX Codex +1 964installs smart-commit Rohit Ghumare smart-commit runs lint, typecheck and tests before a commit, scans staged code for leftovers, then writes a conventional commit message from the diff. CX Codex +1 ★ 2,966repo stars

From the same set148

The whole set →
vex-generation The vex-generation rule guides AI-assisted VEX triage with evidence requirements, confidence bands, and status constraints. Use it when an agent drafts vulnerability findings for human review. CX Codex +1 ★ 1,627repo stars dataops Microsoft DataOps and DS/MLOps testing reference: where to validate data, how to write pipeline tests, and how to tell validation errors from drift. CX Codex +1 ★ 1,627repo stars session-log-canvas-update session-log-canvas-update diffs Copilot session event schemas against the canvas baseline. Keeps the Session Log canvas in sync across Copilot runtime updates. CX Codex +1 ★ 1,627repo stars Backlog Grooming Backlog Grooming reviews selected open GitHub issues against repository evidence and returns a maintainer report without changing those issues. CX Codex +1 ★ 1,627repo stars ux-coaching ux-coaching guides UX practitioners through problem framing, design critique, and stakeholder advocacy by asking questions instead of giving ready-made answers. CX Codex +1 ★ 1,627repo stars RAI Reviewer The RAI Reviewer subagent coordinates codebase assessments against responsible AI frameworks and produces a consolidated report. Use it for audits, change reviews, or plan analysis. CX Codex +1 ★ 1,627repo stars git-setup git-setup audits Git configuration with a single command, finds gaps, and proposes safe fixes for identity, editor, diff and merge tooling. CX Codex +1 ★ 1,627repo stars feasibility Structures and validates durable data and ML feasibility studies using constrained YAML and UUID-tracked provenance. CX Codex +1 ★ 1,627repo stars

Project sponsors

Companies that keep this analytics open