split-commit

Split feature branch history into logical, reviewable commits.

8|Updated Jan 24, 2026
One-click install
npx skills add https://github.com/jfmyers9/agent --skill split-commit-jfmyers9
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: split-commit
Source: https://github.com/jfmyers9/agent/tree/main/skills/split-commit
Command: npx skills add https://github.com/jfmyers9/agent --skill split-commit-jfmyers9

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Repackage a feature branch into clean, logical commits that are easier to review and maintain.

Core Features & Use Cases

  • Split complex branches into logical, reviewable commits that each express a single change.
  • Generate a plan blueprint and execute steps to rewrite history safely and predictably.
  • Use case: before merging a long-running feature branch, organize commits for clearer review and traceability.

Quick Start

Turn a messy branch into a series of well-scoped commits.

Frequently Asked Questions about split-commit

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

FAQPage Schema
How do I split a feature branch into clean, vertical commits for code review?

This Skill automates splitting a feature branch into clean vertical commits by generating a plan blueprint and executing steps to rewrite Git history safely. It organizes messy historical commits into logical units for better traceability and review.

What is the best way to reorganize messy Git branch history before merging?

The best way to reorganize messy Git branch history is to use a blueprint plan that stages commits into logical units. This Skill applies validation checks to safely split complex branches into reviewable, single-change commits before merging.

When do I need to split commits into logical units in a version control workflow?

You need to split commits into logical units in a version control workflow when preparing a long-running feature branch for merge. Splitting historical commits ensures clearer code review, better traceability, and commits that each express a single change.

Does this branch cleanup process require conventional commits or external dependencies?

No, this branch cleanup process does not require external dependencies. It operates independently using internal scripts and rules to validate and stage commit splitting, though it supports workflows that utilize conventional commits for better structure.

How does the blueprint plan work when rewriting Git history to split commits?

The blueprint plan works by mapping out the steps needed to split commits, then executing them sequentially to rewrite Git history. It integrates commit staging and validation checks via included scripts to ensure history is reorganized predictably.

Can I use this to split complex branches without losing changes during history rewrite?

Yes, you can use this to split complex branches safely. It applies validation checks via included scripts during the commit staging process, ensuring no changes are lost and the history rewrite remains predictable and secure.