Manages code synchronization between templates and forks using git subtree.

Install

mkdir -p .claude/skills/foundation-sync && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/11574" && unzip -o skill.zip -d .claude/skills/foundation-sync && rm skill.zip

Installs to .claude/skills/foundation-sync

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Bidirectional sync between a fork project and Foundation_template using git subtree. Pull canonical skills/agents/lessons into the fork, or push contributions back. Use when Caleb says 'run foundation-sync pull/push/status'.
224 chars✓ has a “when” trigger
Intermediate

Key capabilities

  • →Initialize a git subtree relationship for a fork project
  • →Pull upstream changes from Foundation_template into a fork
  • →Push contributions from a fork back to Foundation_template
  • →Show the current sync status between a fork and Foundation_template
  • →Handle merge conflicts during pull operations
  • →Scan for project-specific language on push and pull

How it works

The skill uses `git subtree` commands to manage bidirectional synchronization between a fork project and an upstream template, handling merges and tracking contributions.

Inputs & outputs

You give it
Command (init, pull, push, status) and optional local project path
You get back
Updated local repository, pushed contributions, or sync status report

When to use foundation-sync

  • →Syncing template updates to a fork
  • →Contributing changes back to upstream
  • →Checking sync status

About foundation-sync

Uses git subtree to pull upstream changes or push local contributions back, ensuring merge conflict resolution.

Bidirectional sync between a fork project and Foundation_template using git subtree. Pull canonical skills/agents/lessons into the fork, or push contributions back. Use when Caleb says 'run foundation-sync pull/push/status'.

When not to use it

  • →When the user needs to sync content without using git subtree
  • →When the user needs to perform actions not related to bidirectional syncing
  • →When the user needs to push contributions outside the defined subtree prefixes

Limitations

  • →Fork contributions MUST live in `skills/contributions/` (root) to be pushed.
  • →On push, the skill blocks if project-specific language is found in `.foundation/`.
  • →On pull, the skill warns if project-specific language is found in `.foundation/`.

How it compares

This skill uses `git subtree` for a real 3-way merge, preserving fork edits and surfacing conflicts, which is more reliable than a file-copy approach that silently overwrites changes.

Compared to similar skills

foundation-sync side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
foundation-sync (this skill)05moReviewIntermediate
tmux204moReviewIntermediate
jira118moNo flagsBeginner
triaging-issues54moReviewIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry