recomposing-commits

Reorder, split, and clean git commits through an interactive review process.

408|65|Updated Dec 12, 2024
One-click install
npx skills add https://github.com/deadlock-mod-manager/deadlock-mod-manager --skill recomposing-commits
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: recomposing-commits
Source: https://github.com/deadlock-mod-manager/deadlock-mod-manager/tree/main/.agents/skills/recomposing-commits
Command: npx skills add https://github.com/deadlock-mod-manager/deadlock-mod-manager --skill recomposing-commits

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps developers reorganize and clean up their git commit history before submitting pull requests, ensuring commits are logical and meaningful.

Core Features & Use Cases

  • Worktree Isolation: Creates an isolated environment to rebase and re-structure commits without affecting the original branch.
  • Commit Grouping & Splitting: Allows staging, editing, and splitting commits to improve clarity and purpose.
  • Review & Safety: Prompts for review of the new history before applying changes, protecting against accidental corruption of branches.
  • Use Case: A developer has a feature branch with multiple unrelated changes and messy commits. This Skill guides them step-by-step to rebase, split, and order commits for a clean PR history.

Quick Start

Use the recomposing-commits skill to interactively rewrite your branch history, then review the new commit log before applying changes to your branch.

Frequently Asked Questions about recomposing-commits

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

FAQPage Schema
How do I clean up messy git commits before merging a feature branch?

To clean up messy git commits, this Skill interactively guides you through rebasing, splitting, and reordering commits to ensure your feature branch history is logical and clear before merging.

How does worktree isolation protect my original branch during a rebase?

Worktree isolation creates a separate environment to rebase and restructure commits, ensuring your original branch remains completely unaffected and safe from accidental corruption until you review and apply the final history.

Can I split commits with overlapping file changes in git?

Yes, you can split commits with overlapping file changes. The process stages and edits grouped changes interactively, handling complex overlapping modifications safely while maintaining logical commit organization.

What is the safest way to reorder git commits on a feature branch?

The safest way to reorder git commits is through a review-driven process that enforces safety checks to protect main branches, prompting you to verify the new history before applying any changes to your branch.

Does this git history cleanup process protect main branches from accidental corruption?

Yes, the git history cleanup process enforces safety checks designed specifically to protect main branches, requiring you to review the restructured commit log before any changes are permanently applied to your branch.