config-restore

Restore Claude Code commands, skills, and agents from backup directories to ~/.claude/.

Updated Jan 12, 2026
One-click install
npx skills add https://github.com/ppx123-web/claude-config --skill config-restore
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: config-restore
Source: https://github.com/ppx123-web/claude-config/tree/main/skills/config-restore
Command: npx skills add https://github.com/ppx123-web/claude-config --skill config-restore

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Restores Claude Code configuration files from a backup directory back to ~/.claude/, enabling quick recovery after loss, deletion, or migration of your settings.

Core Features & Use Cases

  • Restore three directories: commands/, skills/, and agents/ to ~/.claude/.
  • Prompt-based overwrite confirmations to prevent accidental data loss.
  • Supports specifying a custom source backup directory and reports a detailed restore summary.

Quick Start

Run the restore script from the backup location to restore commands/, skills/, and agents/ into ~/.claude/.

Frequently Asked Questions about config-restore

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

FAQPage Schema
How do I restore Claude Code configuration files to the ~/.claude/ directory?

Restore Claude Code configurations by running the restore script from your backup location to recover commands/, skills/, and agents/ into ~/.claude/. The process uses rsync when available and falls back to cp, verifying both source and target directories.

Do I need rsync to restore Claude Code backups?

No, rsync is not required to restore Claude Code backups. The restore workflow uses rsync when available for synchronization but automatically falls back to the standard cp command, ensuring the restore process works across different system environments.

Can I specify a custom source directory when restoring Claude Code settings?

Yes, you can specify a custom source backup directory when restoring Claude Code settings. The script allows optional source directory specification, verifies the path, and generates a detailed restore summary reporting exactly which files were recovered.

How does the restore process prevent accidental overwrites of existing Claude Code skills?

The restore process prevents accidental overwrites of existing Claude Code skills by using prompt-based confirmation checks before replacing files. It verifies the target directory and interactively asks for permission to overwrite existing configurations in ~/.claude/.

What is the best way to recover deleted Claude Code agents and commands?

The best way to recover deleted Claude Code agents and commands is to use a dedicated restore workflow that copies these directories from a backup source back to ~/.claude/. It verifies directories and provides a detailed summary of the restored files.