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.