Bidirectional Sync

VerifiedCaution

Synchronize configurations between project .claude/ and ~/.claude/template/ bidirectionally. Runs template-updater then project-updater to push local improvements to the template and pull template updates to the project. Use at session start, after improving shared skills or rules, or periodically to keep both in sync.

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

Recommended for

Our review

Bidirectionally synchronizes project and template configurations by running template-updater then project-updater.

Strengths

  • Maintains consistency between projects and templates
  • Prevents loss of local improvements through correct order
  • Automates file copies and commits

Limitations

  • Relies on template-updater and project-updater sub-skills
  • Depends on 'but' tool for commits
  • Does not handle merge conflicts automatically
When to use it

Use at session start or after improving shared skills/rules to keep project and template aligned.

When not to use it

Avoid if working alone without need for centralized template synchronization.

Security analysis

Caution
Quality score85/100

The skill orchestrates a bidirectional sync workflow using Bash and other skills that involve file operations and version control. While the tools are powerful, the instructions themselves do not perform destructive actions or exfiltration. The risk is managed by requiring user interaction (AskUserQuestion) and relying on documented skill scripts. Caution is warranted due to the use of Bash, but the skill appears legitimate.

No concerns found

Examples

Sync at session start
Run sync skill to get latest template updates into my project.
Push local improvements
I've updated some shared rules in my project, run sync to push them to the template.

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