# Sync > Sync Claude configs from repo to local environment with validation and backup. Use when deploying configuration changes. Use when this capability is needed. - Skill: `tomevault-io/sync-4` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/sync-4` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/sync-4/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/sync-4 --- # /sync ## Usage ```bash /sync # Sync system-configs/.claude/ to ~/.claude/ /sync --dry-run # Preview changes without syncing /sync --backup # Create backup before syncing (default behavior) ``` ## Description Synchronize all Claude configuration files from `system-configs/.claude/` to `~/.claude/` using direct execution with basic validation. The command performs file copying with backup creation and simple validation checks, without deploying multiple agents for a straightforward rsync operation. ## Expected Output ### Standard Sync Output ```text Syncing Claude configurations... Source: system-configs/.claude/ (61 files) Target: ~/.claude/ Pre-sync validation: - Configuration syntax: Valid (15 agents, 37 skills) - Target directory: Ready - Permissions: OK Creating backup: ~/.claude.backup.20250909_143022 Synchronizing files: Agents: 15 files -> ~/.claude/agents/ Skills: 37 skills -> ~/.claude/skills/ Output styles: 8 files -> ~/.claude/output-styles/ Settings: settings.json, statusline.sh, exit_hook.sh CLAUDE.md -> ~/CLAUDE.md Post-sync validation: - File integrity: All files copied successfully - Agent configs: 15/15 valid - Skills: 37/37 valid Sync completed successfully: Files synced: 61 total Backup location: ~/.claude.backup.20250909_143022 Sync time: 2.3 seconds ``` ### Dry Run Output ```text Preview mode - no changes will be made Analyzing configurations: Source: system-configs/.claude/ (61 files) Target: ~/.claude/ Files to sync: - 15 agent files -> ~/.claude/agents/ - 37 skills -> ~/.claude/skills/ - 8 output style files -> ~/.claude/output-styles/ - settings.json -> ~/.claude/settings.json - statusline.sh -> ~/.claude/statusline.sh - exit_hook.sh -> ~/.claude/exit_hook.sh - CLAUDE.md -> ~/CLAUDE.md Preview summary: Total files: 61 configurations ready Backup would be created before sync Estimated time: 2-3 seconds ``` ### Validation Error Output ```text Pre-sync validation failed: Issues found: - Agent syntax error: mobile-engineer.md (line 15: invalid YAML) - Permission denied: ~/.claude/ directory not writable Fix these issues before syncing: 1. Repair YAML syntax in mobile-engineer.md 2. Check ~/.claude directory permissions Run /sync again after addressing these issues. ``` ## Behavior ### What Gets Synced ```yaml Source: ./system-configs/.claude/ Destination: ~/.claude/ Files Synced: - agents/*.md -> ~/.claude/agents/ - skills/*/ -> ~/.claude/skills/*/ (entire skill directories) - Includes: SKILL.md, references/, scripts/, assets/, etc. - output-styles/*.md -> ~/.claude/output-styles/ - settings.json -> ~/.claude/settings.json - statusline.sh -> ~/.claude/statusline.sh - exit_hook.sh -> ~/.claude/exit_hook.sh (optional, validated with sh -n) Also Synced (from system-configs/): - CLAUDE.md -> ~/CLAUDE.md (main Claude configuration) Excluded: - README.md files - AGENT_TEMPLATE.md - AGENT_CATEGORIES.md - SKILL_TEMPLATE.md (in docs/skills/) - AUDIT_VERIFICATION_PROTOCOL.md - *.tmp, *.backup files Skills Directory Structure (Anthropic Format): Each skill is a directory containing: - SKILL.md (required) - Main skill instructions - references/ (optional) - API docs, workflow guides - scripts/ (optional) - Executable scripts - assets/ (optional) - Supporting files - examples/ (optional) - Example outputs Example: skills/code-review/ ├── SKILL.md ├── SECURITY.md ├── PERFORMANCE.md └── scripts/ └── run-linters.sh ``` ### Validation Strategy ```yaml Pre-sync Validation: - Basic syntax check for YAML front-matter - JSON validation for settings.json - POSIX shell syntax check for shell scripts (statusline.sh, exit_hook.sh) - Directory permissions and access Post-sync Validation: - File integrity verification - Basic configuration syntax check - Permissions verification ``` ## Implementation The `/sync` skill executes the standalone `scripts/sync.sh` script, which handles all synchronization logic. ```bash #!/bin/sh # Execute the sync script from the repository ./scripts/sync.sh $ARGUMENTS ``` ## Performance Metrics ### Execution Time - **Direct execution**: 2-4 seconds - **File validation**: <1 second - **Backup creation**: <1 second - **File synchronization**: 1-2 seconds ### Benefits of Direct Execution - **Simplified process**: No complex agent orchestration for file copying - **Faster execution**: Direct operations without agent startup overhead - **Clear output**: Simple progress indication - **Automatic backup**: Creates backup before changes for manual recovery if needed - **Resource efficient**: Minimal system resource usage ## Prerequisites - Source directory `system-configs/.claude/` must exist and contain valid configurations - Target directory permissions must allow read/write access - `rsync` must be available for efficient file synchronization ## Notes - **Direct execution**: Performs file operations directly without agent deployment - **Automatic backup**: Creates backup before any changes (restore manually if needed) - **Basic validation**: Essential checks without complex multi-agent validation - **Clear logging**: Direct progress indication and error reporting - **Integration friendly**: Compatible with existing workflows and CI/CD pipelines - **Performance optimized**: Fast execution through direct file operations The /sync skill provides reliable configuration deployment through direct execution, focusing on the essential task of copying files efficiently with basic validation and backup capabilities. --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/damilola-elegbede-org) — claim your Tome and manage your conversions.