sync-settings

Synchronize Claude Code settings bidirectionally with a GitHub repository.

97|2|Updated Jan 1, 2026
One-click install
npx skills add https://github.com/minorun365/my-claude-code-settings --skill sync-settings
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync-settings
Source: https://github.com/minorun365/my-claude-code-settings/tree/main/claude/skills/sync-settings
Command: npx skills add https://github.com/minorun365/my-claude-code-settings --skill sync-settings

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Claude Code's shared settings, including skills, CLAUDE.md, and mcpServers, can drift between machines. This skill provides bidirectional synchronization between your local Claude Code environment and a GitHub repository to maintain consistency and reduce manual configuration.

Core Features & Use Cases

  • Bidirectional sync of local settings (skills, CLAUDE.md) with the repository, ensuring a single source of truth.
  • Automatic masking of sensitive data (e.g., API keys, tokens) during pushes and guidance for safe pulls.
  • Flexible scope control to align spinnerVerbs and language, and to manage mcpServers across machines.

Quick Start

Run the sync locally to push your settings to the GitHub repository, or pull changes to apply them on this machine.

Frequently Asked Questions about sync-settings

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

FAQPage Schema
How do I sync Claude Code settings across multiple devices?

You can sync Claude Code settings across multiple devices by using bidirectional synchronization with a GitHub repository. This process aligns your local skills, CLAUDE.md, and mcpServers configurations to maintain consistency and reduce manual setup.

How does masking for mcpServers work when pushing settings to GitHub?

Masking for mcpServers automatically redacts sensitive data like API keys and tokens before exporting to your GitHub repository. This ensures that your shared settings remain secure during synchronization while preserving the structure for later pulls.

Can I synchronize CLAUDE.md and skills between my local environment and GitHub?

Yes, you can synchronize CLAUDE.md and skills between your local environment and GitHub. The skill maps local settings to repository paths, enabling bidirectional sync to establish a single source of truth for your configurations.

What is the best way to keep Claude Code mcpServers consistent between machines?

The best way to keep Claude Code mcpServers consistent is through bidirectional synchronization with a GitHub repository. This method applies flexible scope control to manage configurations and safely masks sensitive data across multiple machines.

Do I need a GitHub repository to align spinnerVerbs and language in settings.json?

Yes, a GitHub repository is required to align spinnerVerbs and language in settings.json. The repository acts as the central source of truth for bidirectional synchronization, allowing you to push and pull aligned configurations across your machines.

Why does pulling synced settings require guidance for sensitive data?

Pulling synced settings requires guidance because sensitive data like API keys is masked during the push phase. You need to follow specific instructions to safely restore or remap these masked values locally after pulling the configurations from GitHub.