squash-commits

Consolidate incremental git commits into a single project-compliant commit message.

2|Updated May 24, 2026
One-click install
npx skills add https://github.com/CivicActions/ai-runbook-jh --skill squash-commits-civicactions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: squash-commits
Source: https://github.com/CivicActions/ai-runbook-jh/tree/main/skills/squash-commits
Command: npx skills add https://github.com/CivicActions/ai-runbook-jh --skill squash-commits-civicactions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill resolves the clutter of incremental WIP commits by consolidating them into clean, logical, and project-compliant commit messages before merging.

Core Features & Use Cases

  • Standardized Formatting: Automatically applies project-specific commit conventions, issue references, and voice profiles to squashed messages.
  • Git Workflow Integration: Provides precise interactive rebase or merge commands based on your project's base branch configuration.
  • Use Case: You have five messy commits on a feature branch; use this skill to generate a single, professional commit message and the exact git commands needed to tidy your history.

Quick Start

Use the squash-commits skill to consolidate the last four commits into a single clean commit following the project contract.

Frequently Asked Questions about squash-commits

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

FAQPage Schema
How do I squash multiple incremental git commits into a single clean commit message?

Squashing multiple git commits consolidates incremental WIP history into a single, clean commit message before merging. This skill automates standardized formatting and generates the precise interactive rebase commands needed for pre-merge history tidying.

What is the best way to clean up messy WIP commits before merging a feature branch?

Cleaning up messy WIP commits requires consolidating them into a logical, project-compliant commit message before merging. This skill provides automated squashing to tidy your feature branch history and generate the exact git commands for pre-merge preparation.

Can I automatically format squashed commit messages to match project-specific conventions?

Yes, squashed commit messages can automatically apply project-specific commit conventions, issue references, and voice profiles. This skill requires adherence to your project contract to ensure the consolidated message matches your defined branch naming patterns and formatting rules.

Does automated git squashing work with different development workflows and base branch configurations?

Automated git squashing works across various development workflows by providing precise interactive rebase or merge commands based on your project's base branch configuration. It adapts to different feature branch cleanup and pre-merge history tidying processes.

When should I not use automated squashing for my version control history?

You should not use automated squashing when your project lacks defined commit conventions or a project contract. This skill requires predefined issue reference formats and branch naming patterns to generate compliant consolidated commit messages.