ratchet:update

Update Ratchet framework installations via Nix flake, git clone, or local source.

1|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/netbrain/ratchet --skill ratchet-update
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ratchet:update
Source: https://github.com/netbrain/ratchet/tree/main/skills/update
Command: npx skills add https://github.com/netbrain/ratchet --skill ratchet-update

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detects and automates updating an existing Ratchet installation so users avoid manual cloning, uninstalling, and reinstalling while ensuring slash commands, runtime scripts, agent definitions, and hooks are refreshed.

Core Features & Use Cases

  • Installation detection and scope selection for global and project-local installations, with a prompt if both are present.
  • Multiple update methods: recommends and runs Nix flake updates, performs git clone plus install.sh, or uses a local source path with environment-variable hints.
  • Verification and reporting that counts installed commands, confirms preservation of project data, and instructs the user to restart the session.
  • Use case: keep developer tooling and Claude Code slash commands synchronized across machines and projects after upstream changes.

Quick Start

Run the ratchet:update skill and follow prompts to detect installation scope, choose the update method, and perform the uninstall and reinstall sequence.

Frequently Asked Questions about ratchet:update

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

FAQPage Schema
How do I update Ratchet to the latest version without losing project data?

Updating Ratchet performs an uninstall-and-reinstall sequence that refreshes slash commands, runtime scripts, agent definitions, and hooks while preserving project data. It detects your installation scope and applies the appropriate update method automatically.

What is the best way to refresh Claude Code slash commands after upstream changes?

Refreshing Claude Code slash commands is handled by running the Ratchet update process, which synchronizes developer tooling across machines and projects. It reinstalls the framework using Nix flake, git clone, or a local source path.

Can I update a project-local Ratchet installation separately from a global one?

Yes, you can update project-local and global Ratchet installations separately. The update process detects the installation scope and prompts you to choose which scope to refresh when both are present.

Does the Ratchet update process work with Nix flake installations?

Yes, the Ratchet update process fully supports Nix flake installations. It recommends and runs Nix flake updates as the primary method, but also performs git clone plus install.sh or uses a local source path as alternative update methods.

Why does my Ratchet update fail to apply new agent definitions and hooks?

Ratchet updates apply new agent definitions and hooks by performing a complete uninstall-and-reinstall sequence. If the update fails, ensure your installation method is detected correctly and restart your session after the process completes.

Do I need to restart my session after refreshing Ratchet runtime scripts?

Yes, you need to restart your session after refreshing Ratchet runtime scripts. The update process verifies installed commands, confirms preservation of project data, and explicitly instructs you to restart the session to finalize the update.