Commit Skill

Enforce one logical change per commit using Conventional Commits style.

Updated Apr 22, 2026
One-click install
npx skills add https://github.com/Trong-Tra/agent-skills --skill commit-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Commit Skill
Source: https://github.com/Trong-Tra/agent-skills/tree/main/general/commit
Command: npx skills add https://github.com/Trong-Tra/agent-skills --skill commit-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ensures every commit represents a single logical change to improve traceability and history quality.

Core Features & Use Cases

  • Enforces one logical change per commit to prevent bulk updates.
  • Uses Conventional Commits style for consistent history.
  • Provides guidance on chunking, pre-commit checks, and author/date practices to maintain clean history.

Quick Start

Stage only the files related to a single logical change and commit with a conventional-commit message.

Frequently Asked Questions about Commit Skill

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

FAQPage Schema
How do I keep git history clean with one logical change per commit?

To keep git history clean, stage only files related to a single logical change and commit using conventional-commits messages. This enforces one logically scoped commit per change to improve history clarity and traceability across all workspace repositories.

What is conventional commits style for writing commit messages?

Conventional commits style standardizes commit messages to ensure consistent git history. It provides a structured format for features, bug fixes, refactors, docs, and configuration updates, making changes easier to trace and understand.

How do I split bulk code changes into single-purpose commits?

Split bulk code changes by using a chunking workflow. Stage only the files related to a single logical change, run pre-commit checks, adjust author and date controls, and commit with a scoped message before moving to the next chunk.

Does the one-commit rule apply to all repository types in my workspace?

Yes, the one-commit rule applies across all repositories in your workspace. It handles various change types including features, bug fixes, refactors, docs, and configuration updates to guarantee consistent messages and clean history.

What's the best way to enforce traceability for git refactors and docs?

The best way to enforce traceability is to apply the one-commit rule. By ensuring every commit represents a single logical change with consistent conventional-commit messages, you prevent bulk updates and maintain a clean, traceable git history.

Why should I use pre-commit checks for conventional commit messages?

Pre-commit checks guarantee consistent messages and clean history. They validate that your staged changes represent a single logical change before the commit is finalized, preventing bulk updates from polluting your git history.