commit-plan

Group dirty Git changes into logical commit plans without staging.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Kevin-Mok/ai-cli-dotfiles --skill commit-plan-kevin-mok
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: commit-plan
Source: https://github.com/Kevin-Mok/ai-cli-dotfiles/tree/main/dot_agents/skills/commit-plan
Command: npx skills add https://github.com/Kevin-Mok/ai-cli-dotfiles --skill commit-plan-kevin-mok

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Planning safe, grouped commits for the current repository to avoid risky changes and improve reviewability.

Core Features & Use Cases

  • Inspects the working tree and proposes coherent commit boundaries without mutating files.
  • Groups dirty changes into logical commits, highlighting dependencies and potential conflicts.
  • Identifies risky items (e.g., large binaries, secrets) and suggests safe alternatives.

Quick Start

Ask for a safe commit plan for all dirty changes without staging or committing.

Frequently Asked Questions about commit-plan

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

FAQPage Schema
How do I group dirty changes into logical commits without staging files?

To group dirty changes into logical commits without staging, this Skill performs a read-only analysis of your Git working tree to identify logical boundaries and produce a structured commit plan. It inspects changes across multiple files and branches without writing anything.

What is a safe commit plan for a dirty Git working tree?

A safe commit plan is a structured release strategy generated by read-only analysis of your repository. It groups dirty changes into coherent commits, highlights dependencies, flags risky items like large binaries or secrets, and suggests safe alternatives without mutating files.

Can I plan commits across multiple branches and files in one repository?

Yes, you can plan commits across multiple branches and files in one repository. The Skill applies to any Git workspace where changes are present, analyzing the working tree to propose coherent commit boundaries and structured release planning.

How do I identify risky items like secrets or large binaries before committing?

To identify risky items before committing, the Skill inspects your working tree and flags potential issues such as large binaries and secrets. It then suggests safe alternatives to help you avoid dangerous changes and improve reviewability.

What's the best way to review potential Git conflicts before staging changes?

The best way to review potential Git conflicts before staging is to use a read-only commit plan. It groups dirty changes into logical commits while highlighting dependencies and potential conflicts, allowing for structured release planning without altering your working tree.

Does the commit planning process modify or write changes to my files?

No, the commit planning process does not modify or write changes to your files. It implements a strictly read-only analysis of the working tree to produce a commit plan, ensuring non-intrusive review without staging or committing any dirty changes.