git-commit-helper

Generate Conventional Commits messages from Git staged diffs.

Updated Jul 8, 2024
One-click install
npx skills add https://github.com/alexismanuel/dotfiles --skill git-commit-helper-alexismanuel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-commit-helper
Source: https://github.com/alexismanuel/dotfiles/tree/main/.opencode/skill/git-commit-helper
Command: npx skills add https://github.com/alexismanuel/dotfiles --skill git-commit-helper-alexismanuel

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you craft conventional-commits-compliant messages by analyzing your staged changes and diffs, making commits more meaningful and easier to review.

Core Features & Use Cases

  • Commit message generation: Proposes structured messages following the conventional commits format
  • Guided workflow: Quick-start commands to view diffs, stage changes, and commit
  • Multi-file commits: Supports atomic commits for multiple files

Quick Start

  • View staged changes: git diff --staged
  • Generate a suggested commit message and apply it with your editor (copy-paste the generated message)
  • Commit using the suggested message: git commit -m "<suggested-message>"

Frequently Asked Questions about git-commit-helper

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

FAQPage Schema
How do I write better commit messages following conventional commits format?

Conventional commits format structures messages as type(scope): description with optional body and footer, making commits easier to review and automate. This Skill analyzes your staged Git diffs to generate compliant messages automatically, saving time and ensuring consistency across your project.

Can I automatically generate commit messages from my staged changes?

Yes. This Skill reads git diff --staged output and generates descriptive commit messages formatted in conventional commits style. You review the suggestion, copy it, and apply it when committing—automating the message-writing workflow without manual typing.

How do I commit multiple files atomically with clear messages?

Stage all related files together, then use this Skill to analyze the combined diff and generate a single message that describes the entire changeset. This produces atomic commits where one message accurately reflects all file modifications in scope.

What's the quickest way to view staged changes before committing?

Run git diff --staged to see exactly what you're about to commit. This Skill uses that same output to propose a descriptive message, so you can review both the changes and the message summary in one workflow.

Why should I use structured commit messages instead of freeform text?

Structured messages (conventional commits) enable automated tooling for changelog generation, version bumping, and commit history parsing. They make code review faster because scope and change type are immediately visible, and they follow a standard teams can enforce consistently.

Do I need any setup or dependencies to generate commit messages?

No external dependencies required. You need only a Git repository with staged changes. This Skill works with git diff --staged output directly, integrating into your existing Git workflow without additional configuration.