github-actions
callstackincubator/agent-skills
Reusable GitHub Actions patterns for React Native iOS simulator and Android emulator cloud builds with downloadable artifacts.
What is github-actions?
This skill provides GitHub Actions workflow patterns to build React Native apps for iOS simulators and Android emulators in the cloud, then publish and retrieve artifacts via gh CLI or GitHub API. Use it when setting up CI build pipelines that need stable, downloadable mobile build artifacts.
- Build iOS simulator `.app.tar.gz` artifacts in GitHub Actions using composite actions
- Build Android emulator `.apk` artifacts in GitHub Actions using composite actions
- Upload build artifacts with stable IDs for reliable retrieval
- Download artifacts via `gh run download` command or GitHub REST API
- Wire multiple platform jobs into a single end-to-end workflow
- Capture and use artifact IDs for scripted artifact management
How to install github-actions
npx skills add https://github.com/callstackincubator/agent-skills --skill github-actions- GitHub repository with Actions enabled
- React Native project configured for iOS and Android builds
- gh CLI installed (for gh run download commands)
- GitHub API token with appropriate permissions (for REST API downloads)
How to use github-actions
- 1.Add the iOS composite action from gha-ios-composite-action.md to your repository
- 2.Add the Android composite action from gha-android-composite-action.md to your repository
- 3.Create or update `.github/workflows/mobile-build.yml` using the pattern from gha-workflow-and-downloads.md
- 4.Wire both composite actions into your workflow and configure upload-artifact@v4 steps
- 5.Capture the artifact-id output from upload steps for later retrieval
- 6.Download artifacts using either `gh run download` or the GitHub REST API endpoint
Use cases
- Setting up CI workflows that build React Native simulator/emulator artifacts from PRs or manual dispatch
- Replacing local-only mobile builds with downloadable cloud-built CI artifacts
- Creating reusable composite actions for iOS and Android builds across multiple workflows
- Automating artifact retrieval in downstream scripts or deployment pipelines
- Publishing stable iOS and Android build artifacts for QA or testing teams
- React Native developers setting up CI/CD pipelines
- DevOps engineers managing mobile build infrastructure
- Teams needing downloadable simulator and emulator builds from GitHub Actions
- Developers automating artifact retrieval with gh CLI or REST API
github-actions FAQ
Use the end-to-end workflow pattern from gha-workflow-and-downloads.md, which shows how to wire both the iOS and Android composite actions into separate jobs that run in parallel.
Use `gh run download <run-id>` with the gh CLI, or call the GitHub REST API endpoint `GET /repos/{owner}/{repo}/actions/artifacts/{artifact_id}/{archive_format}` with your captured artifact ID.
iOS builds produce `.app.tar.gz` files for simulator use, and Android builds produce `.apk` files for emulator installation.
Yes, the composite actions are designed to be reusable across different workflows in your repository.
Use `actions/upload-artifact@v4` in your workflow and ensure you capture the artifact-id output for reliable retrieval later.
Full instructions (SKILL.md)
Source of truth, from callstackincubator/agent-skills.
name: github-actions description: GitHub Actions workflow patterns for React Native iOS simulator and Android emulator cloud builds with downloadable artifacts. Use when setting up CI build pipelines or downloading GitHub Actions artifacts via gh CLI and GitHub API. license: MIT
GitHub Actions Build Artifacts
Overview
Reusable GitHub Actions patterns to build React Native apps for iOS simulators and Android emulators in the cloud, then publish artifacts retrievable via gh CLI or GitHub API.
When to Apply
Use this skill when:
- Creating CI workflows that build React Native simulator/emulator artifacts.
- Uploading iOS simulator and Android emulator installables from PRs or manual dispatch runs.
- Replacing local-only mobile builds with downloadable CI artifacts.
- Needing stable artifact IDs/names for scripted retrieval with
ghor REST API.
Quick Reference
- Add composite actions from gha-ios-composite-action.md and gha-android-composite-action.md.
- Wire them into
.github/workflows/mobile-build.ymlfrom gha-workflow-and-downloads.md. - Upload with
actions/upload-artifact@v4and captureartifact-idoutput. - Download with
gh run downloadorGET /repos/{owner}/{repo}/actions/artifacts/{artifact_id}/{archive_format}.
References
| File | Description |
|---|---|
| gha-ios-composite-action.md | Composite action.yml for iOS simulator .app.tar.gz builds and artifact upload |
| gha-android-composite-action.md | Composite action.yml for Android emulator .apk builds and artifact upload |
| gha-workflow-and-downloads.md | End-to-end workflow wiring plus gh and REST download commands |
Problem -> Skill Mapping
| Problem | Start With |
|---|---|
Need CI iOS simulator .app.tar.gz artifact | gha-ios-composite-action.md |
Need CI Android emulator .apk artifact | gha-android-composite-action.md |
| Need one workflow to trigger both platform jobs | gha-workflow-and-downloads.md |
| Need scripted artifact download | gha-workflow-and-downloads.md |
Source Inspiration
Related skills
More from callstackincubator/agent-skills and the wider catalog.

react-native-best-practices
React Native performance optimization guidelines for FPS, bundle size, memory, and animations.

react-native-brownfield-migration
Incremental brownfield migration from native iOS/Android to React Native or Expo using @callstack/react-native-brownfield.

react-native-tv-best-practices
Reviews React Native TV apps for focus, D-pad navigation, 10-foot UI, playback/DRM, and TV performance.

react-navigation
React Navigation UI patterns for stacks, tabs, drawers, and sheets in React Native apps.

upgrading-react-native
Upgrade React Native apps to newer versions with template diffs, dependency updates, and native config migration.

validate-skills
Validate skills against agentskills.io spec and Claude Code best practices.