git-commit

Splits working tree changes into small Conventional Commits with Japanese messages.

1|Updated Feb 16, 2025
One-click install
npx skills add https://github.com/yellow-seed/my-portfolio --skill git-commit-yellow-seed
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: git-commit
Source: https://github.com/yellow-seed/my-portfolio/tree/main/.github/skills/git-commit
Command: npx skills add https://github.com/yellow-seed/my-portfolio --skill git-commit-yellow-seed

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large, mixed-purpose commits make code review painful, hide the reason behind changes, and make it risky to revert a single fix. This Skill analyzes your working tree changes and splits them into multiple small, single-purpose commits that are independently reviewable and revertable. ## Core Features & Use Cases - Change Classification: Categorizes modified files into feature additions, bug fixes, refactoring, docs, tests, config, and dependency updates, then decides what to split versus group together. - Ordered Commit Creation: Stages files selectively (including git add -p for partial staging) and commits in a logical order: config, refactor, fix, feature, tests, docs. - Conventional Commits Messages: Every commit uses the Conventional Commits format in Japanese, with a mandatory self-review step before committing and test verification after each commit. - Use Case: You finished a work session with a Dockerfile, a new API endpoint, its tests, and README updates all uncommitted. The Skill splits these into four clean commits (chore, feat, test, docs) instead of one giant mixed commit. ## Quick Start Review my current uncommitted changes and split them into appropriately sized commits with Conventional Commits messages.

Frequently Asked Questions about git-commit

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

FAQPage Schema
How do I split large changes into multiple git commits?▼

Classify changed files by purpose (feature, fix, refactor, docs, tests, config), then stage and commit each group separately. Use git add with specific file paths or git add -p to stage only parts of a file interactively.

What is a good git commit granularity?▼

A good commit has a single purpose, passes tests on its own, is typically tens to a few hundred lines, and can be reverted independently. Avoid giant commits, mixed unrelated changes, and commits that break the build.

Should tests and code be in the same commit?▼

It depends on coupling. A bug fix and its regression test belong in one commit, while tests for a complex new feature can be committed separately after the feature commit. Related type definitions and their usages should stay together.

What order should I commit refactoring and new features?▼

Commit refactoring first, then the new feature on top of the cleaned-up code. The recommended order is config and dependencies, refactoring, bug fixes, features, tests, then documentation.

How do I stage only part of a file in git?▼

Run git add -p <file> to enter interactive staging, which lets you accept or skip individual hunks of changes. This allows one modified file to contribute to multiple logically separate commits.