commit-helper

Generate conventional commit messages from staged diffs.

2|Updated Dec 12, 2025
One-click install
npx skills add https://github.com/fwdslsh/crosstrain --skill commit-helper-fwdslsh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: commit-helper
Source: https://github.com/fwdslsh/crosstrain/tree/main/demo/fixtures/.claude/skills/commit-helper
Command: npx skills add https://github.com/fwdslsh/crosstrain --skill commit-helper-fwdslsh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the creation of conventional commit messages from diffs, reducing ambiguity and ensuring consistent commit history.

Core Features & Use Cases

  • Generate conventional commit messages from staged diffs
  • Suggest type, scope, subject, body, and footer
  • Enforce 50-char subject line limit and proper formatting
  • Useful for PR reviews and release notes

Quick Start

Feed the current staged changes to the tool, for example: git diff --staged | commit-helper

Frequently Asked Questions about commit-helper

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

FAQPage Schema
How do I generate conventional commit messages from my staged changes?

Conventional commit messages follow a standardized format with type, scope, and subject. Feed your staged diff to commit-helper using `git diff --staged | commit-helper` to automatically generate a formatted message with a summary under 50 characters, blank line, and detailed body describing the why behind your changes.

What is a conventional commit message and why does it matter?

Conventional commits are standardized messages using types like feat, fix, refactor, docs, test, and chore. They reduce ambiguity in commit history, enable automated changelog generation, and make code review clearer by explicitly stating whether changes add features, fix bugs, or address maintenance tasks.

Can I use commit messages to automate release notes and changelogs?

Yes. Conventional commits enable automated release note generation by parsing commit type and scope. Standardized messages from commit-helper produce structured data that tools can extract and organize by feature, fix, and chore categories for consistent changelog output.

How do I enforce a 50-character subject line limit in my commits?

Commit-helper enforces the 50-character subject line limit automatically when generating conventional commit messages from diffs. This constraint keeps commit summaries concise and scannable in logs while the detailed body provides the full context and rationale.

What happens if my diff contains changes across multiple components?

Conventional commits support scope and footer sections to list affected components. Commit-helper generates suggestions for type, scope, and optional footers so you can document which modules or features your diff impacts, improving traceability across your codebase.

Related Skills