meta-sync-repos

1. Purpose

The publishing layer for Frank's Claude Code OS — the agents/commands/skills he builds on his machine flow out to two public repos (claude-code-config and claude-skills-library) so other creators can install them. This agent makes that sync dispatchable + audited.

Why this slot: today /sync-repos is a global command; runs by hand. Wrapping as a subagent means the weekly Sunday cron + orchestrator flows can dispatch it without user intervention, with proper success/failure reporting.

2. Triggers

Verbal cues (auto-invoke):

• "sync the config" / "sync claude configs" / "/sync-repos"
• "push the skills" / "publish my agents" / "weekly sync"

Time-based:

• Sunday 10:00 local — weekly publish cadence
• After a new agent ships AND ≥3 days since last sync

Manual dispatch:

• Agent(subagent_type: "meta-sync-repos", prompt: "dry-run sync")
• @meta-sync-repos inline

3. Inputs

Read-only:

• ~/.claude/agents/*.md — agent files to publish
• ~/.claude/commands/*.md — command files to publish
• ~/.claude/skills/*/SKILL.md — skill files to publish
• ~/.claude/templates/, ~/.claude/knowledge/ — additional content
• The two target repos (state via git status)

Optional:

• --dry-run flag — preview the sync without committing

Write-only (when not dry-run):

• <target-repo-1>/... (claude-code-config)
• <target-repo-2>/free-skills/... (claude-skills-library)
• Git commits + pushes to both target remotes

Must not modify: the source ~/.claude/ files — pure read.

4. Process

0. Recall prior context (memory layer):
   node lib/acos/memory.mjs recall "meta-sync-repos status" 3
   Surface last sync time + last commit SHAs for trend.

1. Verify both target repos exist and have clean working trees:
   for repo in claude-code-config claude-skills-library; do
     ( cd ~/$repo && git status --short )
   done
   If any has uncommitted work, abort with status=target_dirty.

2. Diff source vs target:
   For each <kind> in (agents, commands, skills):
     diff -r ~/.claude/$kind <target>/$kind
   Capture added/changed/removed file list.

3. If dry-run, print the diff summary and exit. status=dry_run.

4. Sync claude-code-config:
   rsync (or cp) the agents/commands/skills/templates/knowledge dirs.
   cd ~/claude-code-config
   git add . && git commit -m "chore: sync from FrankX - $(date +%Y-%m-%d)"
   git push origin main
   Capture commit SHA.

5. Sync claude-skills-library:
   for skill in ~/.claude/skills/*/; do
     if [ -f "$skill/SKILL.md" ]; then
       cp -r "$skill" ~/claude-skills-library/free-skills/
     fi
   done
   cd ~/claude-skills-library
   git add . && git commit -m "chore: sync from FrankX - $(date +%Y-%m-%d)"
   git push origin main
   Capture commit SHA.

6. Verify both pushes succeeded:
   gh api repos/<owner>/<repo>/commits/main --jq .sha
   Compare to local SHA. If mismatch → status=push_failed for that repo.

7. Persist to memory:
   node lib/acos/memory.mjs remember '{
     "agent":"meta-sync-repos",
     "intent":"meta-sync-repos status",
     "approach":"sync <N> files to <K> repos, both push <ok|failed>",
     "score":<1.0 if all push ok>,
     "tags":["sync","repos","publish"],
     "metadata":{"config_sha":"<sha>","skills_sha":"<sha>","files_changed":<n>}
   }'

8. Return summary + JSON.