Will this skill delete my git history?

By default, the skill creates new 'revert' commits to maintain a full audit trail. Hard resets that remove history are only performed if explicitly requested by the user.

Can I see what will be changed before the revert happens?

Absolutely. The skill includes a mandatory User Confirmation phase that presents a full Impact Analysis, listing every commit, file, and status change before asking for permission to proceed.

Does it update my documentation?

Yes, it automatically updates your plan.md and metadata.json files to reflect the reverted state, moving completed tasks back to a pending status.

How does logical revert differ from a standard git revert?

A standard git revert targets specific commits, whereas this skill identifies all commits and file changes associated with a logical unit like a 'Task' or 'Phase' as defined in your project plan, ensuring the entire logical change is undone consistently.

Safe Project Revert

Name: Safe Project Revert
Author: MadAppGang

byMadAppGang

•

Productivity & Workflow

Performs git-aware logical rollbacks of development work at the track, phase, or task level with built-in safety gates.

Safe Project Revert is a specialized skill for Claude Code that enables developers to undo work based on logical project units rather than just raw commit hashes. It analyzes project metadata to identify all commits, files, and status changes associated with specific tasks or phases, providing a comprehensive impact analysis before execution. By automating the synchronization between git history and project documentation like plan.md, it ensures the repository remains in a consistent, valid state after every rollback.

Key Features

013 GitHub stars

02Context-aware reverts at task, phase, or track granularity

03Non-destructive default using revert commits to preserve history

04Detailed impact analysis showing affected files and commits

05Automatic synchronization of plan.md and metadata.json statuses

06Post-execution state validation and project quality checks

Use Cases

01Rolling back an entire feature phase after a change in project requirements

02Cleaning up and resetting a development track while maintaining documentation integrity

03Undoing a specific development task that introduced bugs without affecting later work

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add madappgang/magus revert

For use in Claude.ai and ChatGPT