Agent-Skills.md

Agent Skills: 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.

UncategorizedID: frankxai/frankx.ai-vercel-website/repo-sync-steward

Author

frankxai

https://github.com/frankxai View all skills

Repository

frankxai/frankx.ai-vercel-website

frankxaiLicense: CC0-1.0

31

Install this agent skill to your local

pnpm dlx add-skill https://github.com/frankxai/frankx.ai-vercel-website/tree/HEAD/.claude-skills/projects/repo-sync-steward

Skill Files

Browse the full folder contents for repo-sync-steward.

Loading file tree…

.claude-skills/projects/repo-sync-steward/SKILL.md

Skill Metadata

Name: repo-sync-steward
Description: 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.

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

Fetch and inspect targets

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

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.

Apply to target safely

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

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.

Push + record

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