What problem does it solve? Keeping a personal Claude Code configuration (settings.json, CLAUDE.md, statusline.ts, and custom skills) under version control is risky and tedious: copying everything by hand can leak credentials, history files, or session transcripts into git. This Skill automates a safe, allowlist-based backup of the live ~/.claude directory into a git repo. ## Core Features & Use Cases - Allowlist-based sync: Only settings.json, CLAUDE.md, statusline.ts, own (non-skills.sh) skills, and the skills.sh lock file are ever read; credentials, history, and project transcripts are never touched. - Secret scanning: Every copied text file is scanned for key and token patterns (Anthropic, OpenAI, GitHub, AWS, JWT, private keys); flagged files are skipped and the script exits non-zero. - Dry-run and apply modes: Run a check first to preview changes and orphan skills, then apply the copy with LF line-ending normalization. - skills.sh restore: A companion script reinstalls skills.sh-managed skills from the backed-up lock file on a new machine. - Use Case: After tweaking your global Claude Code settings or adding a new personal skill, run the sync to commit an exact, secret-free snapshot of your config to your backup repo. ## Quick Start Ask Claude to sync your live .claude config into the backup repo by running the sync script in check mode first, then with --apply, and committing the result.
