# Sync Templates

> Bidirectional sync between scaffold templates and vault templates with interactive merge

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

---


# Sync Templates

Synchronize templates between the engine scaffold and your vault. Shows diffs and prompts for each changed file.

## Workflow

### 1. Load Configuration

**Use sub-skill: `_sub/fetch/get-config`**

Extract `vault_path` as `$VAULT`.

### 2. Define Template Pairs

Compare these locations:

| Scaffold (Engine) | Vault (User) |
|-------------------|--------------|
| `scaffold/00_Brain/Systemic/Templates/Captive/*.md` | `$VAULT/00_Brain/Systemic/Templates/Captive/*.md` |
| `scaffold/00_Brain/Systemic/Templates/Periodic/*.md` | `$VAULT/00_Brain/Systemic/Templates/Periodic/*.md` |
| `scaffold/03_Resources/_Templates/para/*.md` | `$VAULT/03_Resources/_Templates/para/*.md` |

### 3. Compare Each Template

For each template file, determine its sync status:

| Status | Condition | Action |
|--------|-----------|--------|
| **Identical** | Files match exactly | Skip (report as synced) |
| **Scaffold only** | File exists only in scaffold | Prompt: copy to vault? |
| **Vault only** | File exists only in vault | Prompt: copy to scaffold? |
| **Different** | Both exist but differ | Show diff, prompt for direction |

### 4. Interactive Merge (Per-File)

For each file that differs, present the diff and ask:

```
📄 Templates/Captive/today.md

--- scaffold (engine)
+++ vault (user)
[diff output]

Choose action:
- ← Pull (vault → scaffold) - bring user customizations to engine
- → Push (scaffold → vault) - apply engine updates to vault
- Skip - leave both unchanged
```

Use `AskUserQuestion` with options:
- `← Pull` - Copy from vault to scaffold
- `→ Push` - Copy from scaffold to vault
- `Skip` - No action for this file

### 5. Execute Actions

For each user decision:
- **Pull**: Copy `$VAULT/.../file.md` → `scaffold/.../file.md`
- **Push**: Copy `scaffold/.../file.md` → `$VAULT/.../file.md`
- **Skip**: No file operation

### 6. Report Summary

Show final summary:

```
Template Sync Complete

✓ Synced: 5 files (identical)
← Pulled: 2 files (vault → scaffold)
→ Pushed: 1 file (scaffold → vault)
⊘ Skipped: 1 file
```

## Notes

- This is a **development skill** for engine maintenance
- Always shows diffs before making changes
- Never overwrites without user confirmation
- Use after modifying templates in either location to keep them in sync