| name | revyl-ci-sync |
| description | Keep a repo's Revyl remote build mirrored with its CI pipeline - update both in the same PR and debug drift between them. |
Revyl CI Sync Skill
Use this skill when changing CI/build configuration in a repo that also has a Revyl remote build configured (.revyl/config.yaml with build.profiles or a remote dev loop in use).
The Principle
Your Revyl remote build should mirror your CI pipeline. Both build the same app from the same source; when they diverge, "works on Revyl, fails in CI" (or the reverse) wastes a debugging session that a one-line sync would have prevented.
The Rule
When a PR changes how CI builds the app — toolchain versions, build flags, env vars, dependency install steps, code signing, prebuild/codegen steps — mirror that change in the Revyl build configuration in the same PR. Not a follow-up.
The Sync-Table Pattern
Keep a small table in the repo (near the CI config or in the repo's agent docs) mapping each CI build step to its Revyl counterpart, for example:
| CI step | Revyl counterpart |
|---|
| pinned Node setup | the selected build.profiles.<profile>.ios recipe env / toolchain |
pod install --repo-update | same step in the Revyl build command |
EXPO_PUBLIC_* env vars | .revyl/config.yaml build env / launch vars |
The table's contents are repo-specific and live in the customer repo — this skill only prescribes the pattern: every row that changes on one side changes on both sides in the same PR.
Debugging Drift
When a build behaves differently on Revyl vs CI:
- Diff the two build commands and their environments first (the sync table makes this a 30-second check).
- Compare toolchain versions actually used (logs on both sides), not the ones assumed.
- Fix by re-syncing the configs, then update the sync table so the drift class cannot silently recur.
