# Repo Sync Steward

> Sync workflow between the FrankX main repo and frankx.ai-vercel-website branches. Use when cherry-picking blog/content/code changes across repos, updating slugs/RSS, and preserving site integrity. Use when this capability is needed.

- Skill: `tomevault-io/repo-sync-steward` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/repo-sync-steward`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/repo-sync-steward/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/repo-sync-steward

---


# Repo Sync Steward

## Scope
Keep the website repo aligned with the main FrankX content and site code without dragging in local tooling or internal docs.

## Workflow

1) Fetch and inspect targets
- Confirm remotes: `origin` (FrankX) and `vercel-website` (site repo).
- Fetch the target branch before syncing.

2) Prepare clean source commits
- Stage only website-relevant paths:
  - `content/blog/**`
  - `public/rss.xml`
  - `lib/**` and `app/**` links that reference blog slugs
  - `next.config.js` redirects (if slugs changed)
- Avoid: `.claude/`, `.tina/`, `.shared/`, `docs/`, `notes.md`, `task_plan.md`.

3) Apply to target safely
- Use a worktree for `vercel-website/<branch>` to avoid dirty state.
- Cherry-pick the prepared commits; resolve conflicts minimally.

4) Validate
- Run `node scripts/validate-blog-frontmatter.js` if available.
- Regenerate RSS with `node scripts/generate_feed.mjs`.
- Scan for old slugs: `rg -n "/blog/0[0-9]-"` and ensure redirects exist.

5) Push + record
- Push to `vercel-website/<branch>`.
- Log what was synced (commit IDs + key files) in a brief note.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/frankxai) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->

