OPOS: Skill for Claude Code

sync-from-core

When to use

Manually, after check-for-updates reports a new version is available. Or unconditionally to pull the latest upstream changes.

Run it in a subagent, never in the interactive main thread (v0.21.0). A sync reads and diffs many files; done inline, all of that output stays in the conversation, and every later request re-reads it. Measured at a consumer: a sync run inside a 450k–900k-token session was the bulk of the 183M tokens its usage dashboard attributed to check-for-updates. Routine releases are applied by the daily SessionStart updater (opos-session-update.mjs), so a manual sync should be rare. When one is needed, apply every pending release in one run, not one run per release.

Inputs

• target_version (optional; default: latest non-prerelease release tag from upstream).
• branch (optional; default: opos-update-<tag>).
• check_only (optional bool; default false): if true, runs copier update --dry-run and prints the diff without creating a branch or modifying files. Useful for previewing changes.

Steps

1. Resolve repo root via git rev-parse --show-toplevel. Ensure the working tree is clean (git status --porcelain returns empty). If not: ABORT with instruction to commit or stash first. Do NOT proceed with a dirty tree — copier update would mix consumer's in-progress edits with upstream changes.
2. Read <repo-root>/.copier-answers.yml. Extract _src_path. Classify it with the same four-shape logic as check-for-updates step 4 (remote GitHub → <owner>/<repo>; existing local clone → warn "local path, non-portable" and resolve tags via git -C <path> tag; missing local path or unparseable → ABORT with: _src_path '<value>' cannot be used for updates on this machine. Edit .copier-answers.yml and set _src_path to gh:<owner>/<repo> (leave _commit untouched), commit, and re-run.). If .copier-answers.yml is missing: ABORT with instruction to scaffold via copier copy first (this skill cannot bootstrap a repo).
3. Resolve target_version:
   • If --target_version passed: use it.
   • Else (remote shape): gh api repos/<owner>/<repo>/releases --jq '[.[] | select(.prerelease == false)] | first | .tag_name' (no leading slash — MSYS/Git-Bash path-mangling on Windows). Local-clone shape: git -C <path> tag --sort=-v:refname | grep -v -- '-' | head -1.
4. If --check_only is true (v0.8.1 rewrite — Copier has no --dry-run, and --pretend is ignored by copier update's patch-apply step, so a real preview needs a throw-away branch): git checkout -b opos-preview-<tag> → copier update --vcs-ref <tag> --defaults --conflict rej → print git status --porcelain (flag .rej files) and git diff --stat → git reset --hard && git clean -fd → git checkout - → git branch -D opos-preview-<tag>. Nothing is committed and the tree is left exactly as found. Skip steps 5–9.
5. Create the update branch: git checkout -b <branch> (default opos-update-<tag>). 5b. Record the current pin as OLD_PIN (_commit in .copier-answers.yml) — step 6c needs it.