ss

Snapshot project state and generate a rollback command for git and non-git projects.

Updated Mar 17, 2026
One-click install
npx skills add https://github.com/Rheinmir/skills-kit --skill ss-rheinmir
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ss
Source: https://github.com/Rheinmir/skills-kit/tree/main/skills/ss
Command: npx skills add https://github.com/Rheinmir/skills-kit --skill ss-rheinmir

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creates a quick, robust snapshot of the current project state and provides a straightforward rollback path if changes prove risky.

Core Features & Use Cases

  • Snapshot in both git and non-git environments with deterministic rollback commands.
  • For git repos, saves work-in-progress by stashing or recording commit, enabling a clean rollback.
  • For non-git projects, performs a timestamped backup with hard-link optimization to minimize duplication.

Quick Start

Run the ss skill to snapshot your current project and generate a rollback command.

Frequently Asked Questions about ss

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

FAQPage Schema
How do I take a project snapshot before making risky changes?

To take a project snapshot, you can run a snapshot command that records the current state and generates a direct rollback command. It works by saving your work-in-progress through stashing or committing in git, or by creating a timestamped backup for non-git projects.

Can I create a rollback path for a non-git project?

Yes, you can create a rollback path for a non-git project by generating a timestamped backup. This process uses hard-link optimization to minimize file duplication while providing a ready rollback command to restore the original state.

How does snapshotting handle a dirty git worktree?

Snapshotting a dirty git worktree works by automatically stashing or committing uncommitted changes. This saves your work-in-progress and enables a clean rollback path to the previous stable state.

What is the best way to backup a local project state without git?

The best way to backup a local project state without git is using a timestamped backup system. This approach captures the current codebase and outputs a deterministic rollback command, ensuring you can safely revert risky changes.

Do I need git installed to use a project snapshot and rollback tool?

No, you do not need git installed to use a project snapshot and rollback tool. The workflow detects git presence and processes git repositories via stash or commit, while falling back to timestamped backups for non-git codebases.