sync-with-claude

Synchronize local ~/.claude configuration folders to the repository with rsync --delete.

3|3|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/twikus/claude-configuration --skill sync-with-claude
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sync-with-claude
Source: https://github.com/twikus/claude-configuration/tree/main/.claude/skills/sync-with-claude
Command: npx skills add https://github.com/twikus/claude-configuration --skill sync-with-claude

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers keep their Claude-related configuration files in a central, version-controlled repository by syncing local ~/.claude data to the claude-code-config folder in this repository, ensuring consistency across environments.

Core Features & Use Cases

  • Syncs critical folders: commands, skills, agents, and scripts from ~/.claude to the repository.
  • Supports safe previews with a dry-run and requires explicit user confirmation before applying changes.
  • Enforces private-data safety by respecting exclusion rules defined in references/do-not-copy.md and protective rules in references/do-not-change.md.

Quick Start

Step 1: Run a dry-run preview of the sync to inspect changes. Step 2: Review the changes and confirm to proceed with the actual sync. Step 3: Monitor the sync outcome in the Actions tab and commit changes if everything looks correct.

Frequently Asked Questions about sync-with-claude

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

FAQPage Schema
How do I sync my local Claude configuration files to a git repository?▼

To sync Claude configuration files, this Skill copies commands, skills, agents, and scripts from your local ~/.claude directory directly into a version-controlled repository folder using rsync.

What is the best way to preview changes before backing up Claude config?▼

The best way to preview Claude config backups is using the built-in dry-run mode. This generates a sync preview showing exactly what files will be added or deleted before you grant explicit confirmation to proceed.

Can I prevent private data from syncing when backing up Claude config files?▼

Yes, you can prevent private data from syncing during Claude config backups. The process enforces safety by strictly respecting exclusion rules defined in a do-not-copy reference file and protective rules in a do-not-change reference file.

Does the config sync process delete files in the target repository folder?▼

Yes, the config sync process deletes files in the target repository folder to maintain an exact mirror. It executes rsync with the --delete flag to ensure the repository strictly matches your local environment configuration.

Do I need to manually confirm before applying config changes across environments?▼

Yes, you need to manually confirm before applying config changes across environments. The sync operation requires explicit user confirmation after the dry-run preview to ensure no unintended modifications occur to your version-controlled files.