commit

Generate contextual Git commit bodies from staged changes.

3.0k|191|Updated Mar 19, 2018
One-click install
npx skills add https://github.com/xtdb/xtdb --skill commit-xtdb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: commit
Source: https://github.com/xtdb/xtdb/tree/main/.claude/skills/commit
Command: npx skills add https://github.com/xtdb/xtdb --skill commit-xtdb

SYSTEM DOCUMENTATION & REQUIREMENTS

## What problem does it solve? This Skill helps developers create git commit messages that explain why changes were made, not just what changed, ensuring clearer project history and easier future maintenance.

## Core Features & Use Cases

  • Generate a concise, reasoning-focused commit body that complements the user-provided headline.
  • Review the conversation history to justify decisions, tradeoffs, and context for future developers.
  • Apply the commit directly to the staged changes, following the workflow rules described in the SKILL.

### Quick Start To use the commit skill, provide a headline like /commit fix: boolean logic error in expression.clj. Ensure changes are staged before invoking the command to allow the tool to draft the body.

Frequently Asked Questions about commit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a git commit message that explains reasoning instead of just what changed?

To write a git commit message explaining reasoning, you provide a concise headline and let the tool generate a body that details decisions, tradeoffs, and context. This ensures future developers understand why changes were made for easier maintenance.

What is the best way to generate a detailed commit body for staged git changes?

The best way to generate a detailed commit body for staged git changes is to use a reasoning-focused commit tool. It reviews your conversation history to justify decisions and automatically drafts the context directly into the staged changes.

How do I apply a generated commit message to my staged git changes?

To apply a generated commit message to staged git changes, you provide a headline command after staging your files. The tool then drafts the reasoning-focused body and applies the commit directly to the staged area following workflow rules.

Do I need to stage my files before generating a reasoning-focused commit message?

Yes, you need to stage your files before generating a reasoning-focused commit message. The tool takes the changes directly from the staged area, so invoking the command with a headline before staging will not allow it to draft the body.

Can I use this commit generation approach for refactoring and bug fixes?

Yes, you can use this commit generation approach for refactoring and bug fixes. It applies across software projects, especially when a detailed rationale for bug fixes, feature work, or refactors improves future maintenance.

Why does my generated commit message include conversation history and tradeoffs?

Your generated commit message includes conversation history and tradeoffs because the tool emphasizes decision context. Reviewing past conversation history justifies the decisions made, ensuring clearer project history and easier future maintenance.