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.