skills.rest
ambroselittle
ambroselittleCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

sync-guidance

Sync local CLAUDE.md with repository rules and templates via git PRs.

Updated Mar 8, 2026
Search Tags:#automation#git#guidance#claude#diff#sync#pull-request
One-click install
npx skills add https://github.com/ambroselittle/agent-skills --skill sync-guidance
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sync-guidance
Source: https://github.com/ambroselittle/agent-skills/tree/main/skills/sync-guidance
Command: npx skills add https://github.com/ambroselittle/agent-skills --skill sync-guidance

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Sync Claude guidance between machines by aligning your local CLAUDE.md with the repository's rules and templates, updating the personal unfenced section, and surfacing novel guidance for a PR.

Core Features & Use Cases

  • Inbound alignment: update this machine's CLAUDE.md from the repo's centralized guidance
  • Outbound collaboration: propose PRs with any new guidance discovered locally
  • Bidirectional sync: handle inbound and outbound directions to maintain consistency across devices

Quick Start

Run this skill on a work machine after cloning the repo to keep local CLAUDE.md in sync with the repo rules and to propose a PR for novel guidance.

Frequently Asked Questions about sync-guidance

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

FAQPage Schema
How do I sync Claude guidance across multiple machines?▼

You can sync Claude guidance by running a bidirectional comparison between ~/.claude/CLAUDE.md and a central git repository. This updates local personal sections and pushes novel guidance as pull requests.

How does a fence-aware CLAUDE.md parser handle diff synchronization?▼

A fence-aware parser identifies fenced and unfenced sections within CLAUDE.md to accurately isolate personal rules from shared templates. It then uses a diff mechanism to align only the appropriate sections during the synchronization process.

Can I propose a pull request for new local Claude guidance rules?▼

Yes, you can propose pull requests for new local Claude guidance rules. The outbound sync flow detects novel guidance on your machine, compares it against the shared repository, and uses git to automatically create a PR for review.

Do I need git to manage CLAUDE.md template alignment?▼

Yes, you need git to manage CLAUDE.md template alignment because the outbound sync flow relies on git to track changes, manage branches, and automatically create pull requests for novel guidance discovered locally.

What is the best way to keep personal and shared Claude guidance sections aligned?▼

The best way to keep personal and shared Claude guidance aligned is bidirectional synchronization between your local machine and a central repository, using a fence-aware parser to separate unfenced personal rules from shared templates.

Related Skills

Explore More Software Engineering Skills→
jota-batutajota-batuta

claude-agent-sdk

Deploy batuta-dots agents headlessly via the Claude Agent SDK.

Community
Advanced
psaabpsaab
8

merge-prs

Merge GitHub pull requests and close referenced issues via gh CLI.

Community
Advanced
erclxerclx
2

aitk-sandbox-check

Audit repository changes for sandbox testing scenario synchronization.

Community
Advanced
apacheapache
79

magpie-setup-shared-config-sync

Sync Claude configuration across machines via local and shared repositories.

Official
Intermediate