skill-rollback

Rollback to a previous git checkpoint tag while preserving LESSONS.md and updating STATE.md.

4.0k|369|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/nyldn/claude-octopus --skill skill-rollback
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-rollback
Source: https://github.com/nyldn/claude-octopus/tree/main/skills/skill-rollback
Command: npx skills add https://github.com/nyldn/claude-octopus --skill skill-rollback

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Rollback to a previous checkpoint in a git workflow safely, preserving critical learnings.

Core Features & Use Cases

  • Preview files that will be affected before rollback
  • Create a safety pre-rollback checkpoint automatically
  • Preserve LESSONS.md and update STATE.md after rollback
  • Rollback without moving HEAD or altering history

Quick Start

Rollback to the specified checkpoint tag after explicit confirmation.

Frequently Asked Questions about skill-rollback

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

FAQPage Schema
How do I safely rollback to a previous git checkpoint without losing recent changes?

To safely rollback to a git checkpoint, this Skill creates a pre-rollback safety backup automatically. It previews affected files, requires explicit confirmation, and performs the rollback without moving HEAD or altering history.

What is the best way to preserve LESSONS.md when reverting to an earlier git tag?

The best way to preserve LESSONS.md during a git rollback is to use a checkpoint process with enforced guardrails. This approach automatically protects your lessons file and updates STATE.md while restoring the desired tag.

Can I preview which files will be affected before doing a git checkpoint rollback?

Yes, you can preview affected files before completing a git checkpoint rollback. The process requires mandatory explicit confirmation after showing the file preview, ensuring you know exactly what will change before proceeding.

Does this git rollback approach alter commit history or move HEAD?

No, this git rollback approach does not alter commit history or move HEAD. It restores your project to a previous checkpoint tag while maintaining your current branch state and creating a safety backup.

Why do I need explicit confirmation before rolling back to a git checkpoint?

You need explicit confirmation before a git checkpoint rollback to enforce safety guardrails and prevent accidental state loss. This mandatory step ensures you review the previewed affected files and approve the pre-rollback safety checkpoint creation.