Sync project and template configurations

VerifiedSafe

Bidirectional sync between project .claude/ and ~/.claude/template/. Runs template-updater then project-updater in correct order to prevent overwrites.

Sby Skills Guide Bot
DevelopmentIntermediate
306/2/2026
Claude Code
#sync#configuration#template#project#bidirectional

Recommended for

Our review

Bidirectionally syncs configurations between the local project (.claude/) and the global template (~/.claude/template/).

Strengths

  • Ensures complete synchronization without accidental overwrites by enforcing a defined order (template first, then project).
  • Allows pushing local improvements to the template and pulling template updates into the project.
  • Leverages dedicated scripts (template-updater and project-updater) for reliable execution.

Limitations

  • Requires manual invocation of external scripts (template-updater and project-updater).
  • Does not automatically handle file conflicts; manual copies may be needed.
  • Scripts must be accessible via the skill's defined path, which can be fragile.
When to use it

At the start of a Claude Code session, after improving shared rules or skills, or periodically to keep project and template aligned.

When not to use it

When there are no changes to synchronize, or when working on a solo project without a template.

Security analysis

Safe
Quality score85/100

The skill only orchestrates usage of other skills and suggests standard version control commands (using 'but' tool) for syncing configuration. No destructive, exfiltrating, or obfuscated actions are present. The allowed tools are appropriate for the task.

No concerns found

Examples

Full bidirectional sync
Sync between project .claude/ and ~/.claude/template/.
Push local improvements to template
Push my latest .claude/ changes to the template and then pull template updates back.
Pull template updates at session start
Start of session: sync template into project .claude/.

name: sync description: > Synchronize project and template configurations bidirectionally. Runs template-updater then project-updater in correct order. Use when syncing changes between project .claude/ and ~/.claude/template/. allowed-tools: [Bash, Read, Write, AskUserQuestion]

Sync

Bidirectional sync between project .claude/ and ~/.claude/template/.

Why Order Matters

  1. template-updater first - Push local improvements to template
  2. project-updater second - Pull template updates to project

Running in wrong order would overwrite local improvements before they're pushed.

Workflow

  1. Use the Skill tool to invoke /template-updater - this loads the skill with the correct script path
  2. Handle any file copies needed
  3. Use the Skill tool to invoke /project-updater - this loads the skill with the correct script path
  4. Handle any file copies needed
  5. Summarize what changed

Do NOT guess script paths. Each skill's SKILL.md documents its own script.

After Sync

If any files were copied, commit the changes:

Project changes:

but status
but commit <branch> --only -m "chore: sync claude config from template"

Template changes:

cd ~/.claude && but status
but commit <branch> --only -m "chore: update template from project"

When to Use

  • At session start (get latest template updates)
  • After improving shared skills/rules (push to template)
  • Periodically to keep project and template aligned
Related skills