git-commit-writer

Generate Conventional Commits-compliant commit messages from git diffs.

6|3|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/theneoai/skill-writer --skill git-commit-writer-theneoai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-commit-writer
Source: https://github.com/theneoai/skill-writer/tree/main/examples/git-commit-writer
Command: npx skills add https://github.com/theneoai/skill-writer --skill git-commit-writer-theneoai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the guesswork from writing commit messages by turning git diffs or plain-text change summaries into clean, spec-compliant Conventional Commits.

Core Features & Use Cases

  • Generate Commit Messages: Convert a code diff or change description into a properly formatted commit subject and optional body.
  • Validate Existing Messages: Check whether a commit message follows the Conventional Commits 1.0.0 format, mood, scope, and breaking-change rules.
  • Scope and Type Inference: Infer the most appropriate type and scope from changed files and change intent, including common cases like features, fixes, docs, tests, and CI updates.
  • Safety and Recovery: Handle ambiguous input with clarifying questions, confidence thresholds, and human-review escalation when the message cannot be determined reliably.

Quick Start

Use the git-commit-writer skill to analyze my diff and give me the best Conventional Commit message, or validate the commit message I already wrote.

Frequently Asked Questions about git-commit-writer

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

FAQPage Schema
How do I generate a conventional commit message from a git diff?

You can generate a conventional commit message from a git diff by analyzing your code changes and change intent. The skill applies type validation, scope inference, and imperative mood to output a spec-compliant commit message.

Can I validate an existing commit message against the Conventional Commits 1.0.0 spec?

You can validate an existing commit message against the Conventional Commits 1.0.0 specification. The skill checks your message for correct format, mood, scope, and breaking-change rules to ensure full compliance.

How does scope and type inference work for conventional commits?

Scope and type inference works by analyzing changed files and change intent to determine the appropriate category like features, fixes, docs, or CI updates. This process automatically maps your code modifications to the correct conventional commit type.

What happens when my git diff is ambiguous for commit message generation?

When your git diff is ambiguous for commit message generation, the skill triggers human-review escalation. It uses confidence thresholds and asks clarifying questions rather than guessing the commit type or scope unreliably.

Does the conventional commit writer enforce subject length limits and imperative mood?

Yes, the conventional commit writer enforces subject length limits and imperative mood. It ensures your generated commit messages strictly follow formatting rules required by the Conventional Commits specification.