squashing-history

Official

Consolidate git history into one clean commit.

AuthorSocketDev
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill provides a safe, auditable method to rewrite a Git history by squashing all commits on the main branch into a single "Initial commit" while preserving code integrity, with a backup branch for rollback and explicit user confirmation before destructive actions.

Core Features & Use Cases

  • Backup-first history rewrite: creates a timestamped backup branch to restore if needed.
  • Integrity verification: verifies no code changes by diffing against the backup.
  • User-controlled force push: requires explicit confirmation before pushing to origin/main.
  • Applicability: ideal for public releases, simplifying contributor history, or removing sensitive data after prior edits.

Quick Start

Follow the Phase-based workflow: Phase 1 checks, Phase 2 creates backup, Phase 3 records state, Phase 4 soft-resets to first commit, Phase 5 creates a single "Initial commit", Phase 6 validates zero diffs, Phase 7 confirms readiness, Phase 8 force-push after consent, Phase 9 completes and documents rollback.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: squashing-history
Download link: https://github.com/SocketDev/socket-btm/archive/main.zip#squashing-history

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.