Agent skill

Prime Sync

by avibebuilder in avibebuilder/claude-prime

Syncs Claude config between prime repo and target projects. An agent skill from avibebuilder/claude-prime.

MITAuto-check passed

Install Prime Sync

skills CLI
$ npx skills add avibebuilder/claude-prime --skill prime-sync -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install avibebuilder/claude-prime prime-sync --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/avibebuilder/claude-prime.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/prime-sync .claude/skills/prime-sync && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
prime-sync
GitHub stars
120
Token cost
~1.2k tokens
SKILL.md length
583 words
Files
1
Skills in repo
19
Repo updated
First seen
Licence
MIT

At a glance

Syncs Claude config between prime repo and target projects. An agent skill from avibebuilder/claude-prime.

  • Works in 6 steps: Validate Target → Parallel Analysis → Build Sync Plan → …
  • Sync claude config
  • SKILL.md covers Mode Detection, Push Mode — Resolve Target, Pull Mode — Clone Prime and Process, plus 3 more sections
  • Calls git

What it does

Prime Sync is an agent skill from avibebuilder/claude-prime. Syncs Claude config between prime repo and target projects. Trigger on 'sync', 'prime-sync', 'push config', 'pull config', 'update prime', 'sync claude config'. Push mode deploys to targets; pull mode imports changes back.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: You've heard Claude Code can do amazing things. Skills, hooks, agents, memory systems — but who has time to figure all that out? Claude Prime sets it up for you in one command. The licence is MIT.

When your agent uses it

  • Sync claude config

Example prompts

  • “prime-sync”
  • “push config”
  • “pull config”
  • “/prime-sync”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Validate Target
  2. Parallel Analysis
  3. Build Sync Plan
  4. Handle Conflicts
  5. Execute Sync
  6. Report

What it can do on your machine

Read from SKILL.md and the folder at commit 80bcfa4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Prime Sync loads about 1.2k tokens when it runs. Until then it costs about 58 tokens; SKILL.md has 583 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~58
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from avibebuilder/claude-prime at commit 80bcfa4, republished under its MIT licence (© avibebuilder). 583 words, ~1,216 tokens.

Download SKILL.mdSave it as .claude/skills/prime-sync/SKILL.md (or your agent's skills folder).
name
prime-sync
description
Syncs Claude config between prime repo and target projects. Trigger on 'sync', 'prime-sync', 'push config', 'pull config', 'update prime', 'sync claude config'. Push mode deploys to targets; pull mode imports changes back.
argument-hint
[<target-project-path>] (push mode only, optional in pull mode)
disable-model-invocation
true

Ultrathink.

Mode Detection

Detect operating mode before anything else:

  1. VERSION file exists in CWD → push mode (CWD is the prime repo)
  2. .claude/.prime-version exists in CWD → pull mode (CWD is a target project)
  3. Neither detected → ask user which mode and for the required path

Push Mode — Resolve Target

Source = CWD (prime repo). Target = resolved project path.

State file: .claude/prime-projects.json

Tracks known target paths, last sync time, and version. Shape:

json
{ "projects": [{ "path": "/absolute/path", "lastSynced": "2025-12-30T10:30:00Z", "version": "1.4.2" }] }

Create as { "projects": [] } if missing.

Resolution flow:

  1. Argument provided → Use that path, then record it after a successful sync
  2. No argument, known projects exist → Ask the user which project(s) to sync, including an All projects option
  3. No argument, no known projects → Ask the user for a path

State file management:

  • Create .claude/ only if you need to persist the state file
  • Update the synced project's time/version only after a successful sync
  • Keep one entry per absolute path

Pull Mode — Clone Prime

Source = cloned prime repo. Target = CWD.

Flow:

  1. Read current version from .claude/.prime-version in CWD
  2. Generate timestamp: date +%Y%m%d%H%M%S
  3. Clone prime repo: git clone https://github.com/avibebuilder/claude-prime.git /tmp/claude-prime-sync-<timestamp>/
  4. Set source = /tmp/claude-prime-sync-<timestamp>/, target = CWD
  5. Continue to shared process below
  6. Clean up /tmp/claude-prime-sync-<timestamp>/ after sync completes (success or failure)

No state file in pull mode — the target project is self-contained.

Process

1. Validate Target
  • Check that the target path exists, is a directory, and is not the same location as the source repo
  • Treat a valid target as a project root where writing .claude/ is appropriate
  • Read versions from target (.claude/.prime-version) and prime (VERSION)

If the path fails those checks, abort and explain why.

2. Parallel Analysis

Change Detection:

  • Detect relevant changes in prime's .claude/ based on the target's recorded version state
  • If the target has no recorded version, or already matches the current prime version, sync only uncommitted prime changes
  • If the target is on an older prime version, diff from that version tag to HEAD and include uncommitted changes; warn if the tag is missing
  • Categorize changes into commands, agents, hooks, settings, skills, and starter-skills

Stack Detection (only if skills or starter-skills changed): check target for stack indicators relevant to each changed skill/starter.

File Comparison: compare each changed file with target. Detect: NEW, UPDATE, IDENTICAL, CONFLICT.

Show full SKILL.md (209 more words)Show less
3. Build Sync Plan

Aggregate results and present:

CHANGED (will sync): ...
IDENTICAL (skip): ...
CONFLICTS (will ask): ...
IRRELEVANT (skip, wrong stack): ...

GATE: User approves sync plan.

4. Handle Conflicts

For each conflict, show the relevant diff and ask the user how to proceed:

  • Overwrite — Replace the target copy with the prime version
  • Skip — Leave the target copy unchanged
  • Merge — Surface the full diff and let the user choose which parts to keep before writing anything
5. Execute Sync
  1. Create .claude/ in target if needed
  2. Copy approved files (skills as entire folders)
  3. Sync approved starter-skills to .claude/starter-skills/ in target
  4. Update .prime-version with prime's VERSION
6. Report
Sync complete! (prime vX.X.X)
Updated: ...
Skipped: ...
Version: X.X.X → written to .prime-version

Push mode only: update state file (lastSynced timestamp + version). Pull mode only: clean up /tmp/claude-prime-sync-* clone directory.

Gotchas

  • prime-sync stays in prime — do not copy this skill into target projects.
  • Push and pull keep different state — state file is push-only; pull mode treats the target as self-contained.
  • Version history can be incomplete — if the expected tag is missing, warn and continue with that uncertainty explicit.

Constraints

  • NEVER modify the target project's source code
  • NEVER sync without user approval at the plan gate
  • In push mode, preserve one state entry per target path and update it only after success
  • In pull mode, always clean up the temporary clone, even on failure

Target Path

<target-path>$ARGUMENTS</target-path>

© avibebuilder, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/prime-sync of avibebuilder/claude-prime.

Open the folder on GitHubat commit 80bcfa4

Compare with similar skills

Prime Sync next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Prime Sync compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Prime Sync this skillavibebuilder/claude-prime120—~1.2kAutomated safety check: PassMIT
Claude-Mem Cloud Syncthedotmack/claude-mem97k—~1kAutomated safety check: NotesApache-2.0
Agent Sync Coordinatorruvnet/ruflo74k2 repos~4kAutomated safety check: PassMIT
I18n Syncaffaan-m/ECC274k—~1.8kAutomated safety check: PassMIT
Agent Project Board Syncruvnet/ruflo74k2 repos~2.9kAutomated safety check: PassMIT
Fal Lip Syncnexu-io/open-design100k—~308Automated safety check: PassApache-2.0

Similar skills

  • Claude-Mem Cloud Sync

    thedotmack/claude-mem

    Checks claude-mem cloud sync status and guides you through connecting a cmem.ai Pro account without the sync token ever passing through the chat.

    97k GitHub stars~1k tokensUpdated yesterday
    Agent WorkflowsAuto-check: notes
  • Agent skill for sync-coordinator - invoke with $agent-sync-coordinator

    74k GitHub starsUsed in 2 repos~4k tokens
    Auto-check passed
  • I18n Sync

    affaan-m/ECC

    Translate and synchronize application JSON locale files using source-key usage, project terminology, and focused validation.

    274k GitHub stars~1.8k tokensUpdated 2 days ago
    Frontend & DesignAuto-check passed
  • Agent skill for project-board-sync - invoke with $agent-project-board-sync

    74k GitHub starsUsed in 2 repos~2.9k tokens
    Auto-check passed
  • Fal Lip Sync

    nexu-io/open-design

    Create talking head videos and lip sync audio to video via fal.ai.

    100k GitHub stars~308 tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • gbrain Sync

    garrytan/gstack

    Re-indexes a repository into gbrain and refreshes the agent search guidance in CLAUDE.md, safe to run again whenever search results look stale.

    136k GitHub stars~15k tokensUpdated yesterday
    Agent WorkflowsAuto-check: notes

More from avibebuilder/claude-prime

All 19 skills in this repo
  • Diagnose

    avibebuilder/claude-prime

    Investigate unexpected behavior and mysterious bugs. An agent skill from avibebuilder/claude-prime.

    120 GitHub starsUsed in 1 repo~1.2k tokens
    Auto-check passed
  • Frontend Design

    avibebuilder/claude-prime

    Builds distinctive, production-grade UIs that avoid generic AI aesthetics.

    120 GitHub stars~2.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Media Processor

    avibebuilder/claude-prime

    Specialized visual and multimedia processing tools. An agent skill from avibebuilder/claude-prime.

    120 GitHub stars~1.2k tokensUpdated 4 mo ago
    Auto-check: notes
  • Skill Creator

    avibebuilder/claude-prime

    A skill your agent uses when the user wants to work on a Claude Code skill file (SKILL.md): writing one from scratch, testing whether an existing one works well, running evals or benchmarks…

    120 GitHub stars~8.2k tokensUpdated 4 mo ago
    Auto-check passed
  • Self Evolve

    avibebuilder/claude-prime

    The single config quality skill. An agent skill from avibebuilder/claude-prime.

    120 GitHub stars~1.9k tokensUpdated 4 mo ago
    Auto-check passed
  • Cook

    avibebuilder/claude-prime

    Implement, build, create, or add any feature, endpoint, page, component, or functionality.

    120 GitHub stars~970 tokensUpdated 4 mo ago
    Auto-check passed

Questions about Prime Sync

What does Prime Sync do?

Syncs Claude config between prime repo and target projects. An agent skill from avibebuilder/claude-prime. Prime Sync is an agent skill from avibebuilder/claude-prime. Syncs Claude config between prime repo and target projects.

When should I use Prime Sync?

Prime Sync fits situations like: sync claude config.

How do I install Prime Sync in Claude Code?

Run `npx skills add avibebuilder/claude-prime --skill prime-sync -a claude-code`. Or copy the skill folder (.claude/skills/prime-sync in avibebuilder/claude-prime) into .claude/skills/prime-sync in your project. Claude Code loads it when a task matches its description.

How do I install Prime Sync in Codex?

Run `npx skills add avibebuilder/claude-prime --skill prime-sync -a codex`. Or copy the skill folder (.claude/skills/prime-sync in avibebuilder/claude-prime) into .agents/skills/prime-sync in your project. Codex loads it when a task matches its description.

Can I use Prime Sync in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add avibebuilder/claude-prime --skill prime-sync -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/prime-sync, .gemini/skills/prime-sync, .github/skills/prime-sync and .opencode/skills/prime-sync in your project.

What does Prime Sync need to run?

Going by SKILL.md and its folder, Prime Sync needs the command-line tools its instructions call (git).

Does Prime Sync access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Prime Sync safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Prime Sync use?

Prime Sync is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Prime Sync use?

About 1.2k tokens (SKILL.md is roughly 4.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Prime Sync?

Skills that share tags, products or a category with Prime Sync: Claude-Mem Cloud Sync (thedotmack/claude-mem, 97k stars), Agent Sync Coordinator (ruvnet/ruflo, 74k stars), I18n Sync (affaan-m/ECC, 274k stars) and Agent Project Board Sync (ruvnet/ruflo, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Prime Sync?

avibebuilder (a GitHub organization) maintains it in avibebuilder/claude-prime, which has 120 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on May 16, 2026.

Source: avibebuilder/claude-prime on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.