commit-message

Generate commit messages from staged git changes following project conventions.

Updated May 26, 2026
One-click install
npx skills add https://github.com/robot-denny/ai-sketchlab --skill commit-message-robot-denny
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: commit-message
Source: https://github.com/robot-denny/ai-sketchlab/tree/main/.agents/skills/commit-message
Command: npx skills add https://github.com/robot-denny/ai-sketchlab --skill commit-message-robot-denny

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing commit messages that both summarize what shipped and preserve the reasoning behind a change is tedious and often skipped, leaving history that is hard to scan or reconstruct later. ## Core Features & Use Cases - Staged-change analysis: Reads git status and the staged diff to understand exactly what is being committed. - Convention matching: Follows the project's commit format from .agents/config/conventions.md, or infers prefixes, trailers, and casing from recent git history. - Structured message shape: Opens with a plain-language summary of what shipped, then compresses the why into a body under roughly 150 words. - Approval gate: Shows a summary and proposed message, then waits for confirmation — it never auto-commits. - Use Case: After staging a refactor, invoke the skill to get a commit message that leads with what changed and records the motivation a future reader could not recover from the diff. ## Quick Start Analyze my staged changes and propose a commit message following this project's conventions, then wait for my approval before committing.

Frequently Asked Questions about commit-message

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

FAQPage Schema
How do I generate a commit message from staged changes?

Stage your changes with git add, then invoke the skill. It reads git status and the staged diff, proposes a message following your project's conventions, and waits for your approval before committing.

How does the skill detect my project's commit message convention?

It first checks .agents/config/conventions.md for a commit format section. If that is empty, it inspects the last 30 commits with git log to infer prefixes, trailers, casing, and subject-line style from actual history.

Does the commit message skill commit automatically?

No. It shows a summary of staged changes and a proposed message, then waits for explicit confirmation. It only runs git commit after you approve the message.

What happens if nothing is staged when I run it?

The skill checks the staged diff first and stops with a notice if nothing is staged. You need to stage changes with git add before it can propose a message.

How long should the generated commit message body be?

The skill targets a body under roughly 150 words, with about 250 words as the ceiling for changes carrying multiple independent decisions. Longer reasoning is pointed to an ADR or feature doc instead.