gsd-undo

Revert git commits with dependency checks using phase manifests.

Updated May 3, 2026
One-click install
npx skills add https://github.com/ThiagoVitale/endless-crystal --skill gsd-undo-thiagovitale
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-undo
Source: https://github.com/ThiagoVitale/endless-crystal/tree/main/.codex/skills/gsd-undo
Command: npx skills add https://github.com/ThiagoVitale/endless-crystal --skill gsd-undo-thiagovitale

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a safer way to roll back phase or plan commits in git, with comprehensive dependency checks to prevent unintended data loss.

Core Features & Use Cases

  • Safe Git Revert: Roll back specific phases or plans with built-in dependency checks.
  • Commit Selection: Select commits using phase manifests, git logs, or direct commit references.
  • Use Case: If a project phase goes wrong, use this Skill to revert the commits associated with that phase, ensuring that you don't disrupt the rest of the codebase.

Quick Start

Undo the latest phase or plan changes by running $gsd-undo --last N or specify a phase or plan with $gsd-undo --phase NN or $gsd-undo --plan NN-MM.

Frequently Asked Questions about gsd-undo

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

FAQPage Schema
How do I safely revert git commits for a specific project phase without breaking dependencies?

You can safely revert git commits by selecting specific phase or plan commits through phase manifests or git logs. The process runs dependency checks to prevent unintended data loss before rolling back the targeted changes.

What is the best way to roll back the last few commits in a git repository?

The best way to roll back the last few commits is by using the undo command with the last flag, targeting the most recent phase changes. This approach ensures a controlled rollback by verifying dependencies before modifying the repository history.

How do I undo a specific plan or phase commit in git?

You can undo a specific plan or phase commit by specifying the plan or phase number directly in the undo command. This targets the exact commit group for reversion while running checks to ensure codebase stability.

Do I need git to access commit history for rolling back phase changes?

Yes, you need git to access commit history and phase manifests for rolling back changes. The Skill relies on git logs and references to identify the exact commits associated with a specific phase or plan before performing dependency checks.

When should I use dependency checks before reverting commits?

You should use dependency checks before reverting commits whenever a project phase goes wrong and you need to undo changes. This precaution prevents unintended data loss and ensures that rolling back the phase does not disrupt the rest of the codebase.