| name | capgo-release-workflows |
| description | Guides the agent through setting up Capgo-centered release workflows for Capacitor apps. Use when the user needs a unified path for live updates, native builds, and app store publishing using Capgo plus repository-owned CI/CD. Do not use for non-Capacitor frameworks or for Ionic Enterprise plugin migration. |
Capgo Release Workflows
Set up release workflows for Capacitor apps using Capgo live updates plus repository-owned build and publishing automation.
When to Use This Skill
- User wants one release workflow covering live updates, builds, and store publishing
- User is replacing a hosted release service with repo-owned automation
- User wants Capgo for OTA updates and standard CI/CD for native artifacts
Scope
This skill coordinates three workflow areas:
- live updates ->
capgo-live-updates
- native builds ->
capacitor-ci-cd
- app store publishing ->
capacitor-app-store
Use this skill as the top-level router when the user asks for the whole release system, not just one piece.
Procedures
Step 1: Identify Release Requirements
Determine whether the app needs:
- OTA web updates
- signed iOS and Android builds
- TestFlight or Google Play publishing
- staged channels or phased rollout
Record which parts already exist in the repository.
Step 2: Set Up Live Updates
If OTA updates are required, use the capgo-live-updates skill.
Preserve the app's release channel structure and define the rollback strategy before enabling automatic rollout.
Step 3: Set Up Native Build Automation
If the team needs reproducible native builds, use the capacitor-ci-cd skill.
Keep signing, build environment variables, and version bumping under repository control.
Step 4: Set Up Store Publishing
If automated publishing is required, use the capacitor-app-store skill.
Keep credentials, track selection, and release gating aligned with the current release policy.
Step 5: Verify the End-to-End Release Flow
Verify the workflow in order:
- native build succeeds
- store artifact is valid
- live update upload works for the matching app version
- rollback and channel targeting behave as expected
Error Handling
- For OTA setup issues, validate the Capgo plugin startup and rollback path before enabling broad rollout.
- For CI/CD failures, fix signing and environment inputs before changing release logic.
- For store publishing failures, isolate Apple and Google pipelines so one platform does not block diagnosis of the other.
