write-git-commit

Generate conventional git commits from uncommitted changes with why-context.

Updated Mar 29, 2024
One-click install
npx skills add https://github.com/addisonbeck/nix --skill write-git-commit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-git-commit
Source: https://github.com/addisonbeck/nix/tree/main/bobert/skills/write-git-commit
Command: npx skills add https://github.com/addisonbeck/nix --skill write-git-commit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creates high-quality git commits from uncommitted changes following conventional commit standards. Analyzes diffs, requires user-provided "why" context, matches local repository style, detects splitting opportunities, and executes pre-commit verification. Use when committing changes during development or reflect phases.

Core Features & Use Cases

  • Orchestrates the full commit lifecycle: context gathering, diff analysis, message generation, pre-commit verification, staging guidance, execution, and verification.
  • Enforces conventional commit structure and provides automation around type, scope, subject, and body formatting.
  • Supports split-advisory workflows to split large changes into cohesive commits and ensures compliance with repository conventions.

Quick Start

Generate a conventional git commit for my current uncommitted changes, including the motivation why, optional scope, and a concise, well-formed subject with a detailed body.

Frequently Asked Questions about write-git-commit

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

FAQPage Schema
How do I generate a conventional git commit from uncommitted changes?

You can generate a conventional git commit by applying this Skill to your uncommitted changes. It analyzes your diffs, requires you to provide motivational why-context, matches local repository style, and runs pre-commit verification before assembling the final message.

What is the best way to automate conventional commit message formatting?

The best way to automate conventional commit formatting is using a Skill that orchestrates the full commit lifecycle. It interprets diffs, enforces type and scope rules, and provides explicit staging guidance to ensure compliance with repository conventions.

How do I split large git diffs into cohesive conventional commits?

To split large diffs into cohesive commits, the Skill detects splitting opportunities during diff analysis and advises a split workflow. This ensures large changes are broken into logical, convention-compliant commits.

Do I need to provide context for automated git commit generation?

Yes, you need to provide motivational why-context for automated git commit generation. The Skill enforces input validation and requires user-provided context to craft a high-quality commit message that explains the reasoning behind the changes.

Can I run pre-commit checks automatically when generating a git commit?

Yes, you can run pre-commit checks automatically when generating a git commit. The Skill executes pre-commit verification as part of its lifecycle orchestration, ensuring your changes pass checks before final staging and execution.

Does this conventional commit tool work with existing repository styles?

Yes, this conventional commit tool works with existing repository styles. During context gathering, it matches local repository conventions and enforces compliance to ensure generated messages align with your project's formatting standards.