Communityコーディング&開発github.com

github-actions

React Native アプリの iOS シミュレータおよび Android エミュレータ向けビルド成果物を GitHub Actions でクラウド生成し、gh CLI や GitHub API でダウンロード可能にする CI ワークフローパターン。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/callstackincubator/agent-skills/tree/main/skills/github-actions
AI Overview & Summary

このスキルは、React Native アプリの iOS シミュレータ(.app.tar.gz)および Android エミュレータ(.apk)のビルド成果物を GitHub Actions 上でクラウド実行し、ダウンロード可能なアーティファクトとして公開するための再利用可能な CI ワークフローパターンを提供します。主に GitHub Actions を CI 基盤としているプロジェクトで、従来ローカルで行っていたモバイルビルドを CI に移行したい場合や、プルリクエストや手動実行から誰でも簡単にビルド成果物を取得できる環境を整えたい場合に適用します。スキルは、iOS 用の複合アクション、Android 用の複合アクション、および両プラットフォームのジョブを統合するワークフローの 3 つの参照ファイルで構成されており、`actions/upload-artifact@v4` でアップロード後にアーティファクト ID をキャプチャし、`gh run download` や GitHub REST API(`GET /repos/{owner}/{repo}/actions/artifacts/{artifact_id}/{archive_format}`)を用いてスクリプトから安定したダウンロードが可能です。Callstack Incubator の知見を基に作られており、iOS・Android 双方のエミュレータ向け CI パイプラインを迅速に構築できます。

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

ドキュメント

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 gh or REST API.

Quick Reference

  1. Add composite actions from gha-ios-composite-action.md and gha-android-composite-action.md.
  2. Wire them into .github/workflows/mobile-build.yml from gha-workflow-and-downloads.md.
  3. Upload with actions/upload-artifact@v4 and capture artifact-id output.
  4. Download with gh run download or GET /repos/{owner}/{repo}/actions/artifacts/{artifact_id}/{archive_format}.

References

FileDescription
gha-ios-composite-action.mdComposite action.yml for iOS simulator .app.tar.gz builds and artifact upload
gha-android-composite-action.mdComposite action.yml for Android emulator .apk builds and artifact upload
gha-workflow-and-downloads.mdEnd-to-end workflow wiring plus gh and REST download commands

Problem -> Skill Mapping

ProblemStart With
Need CI iOS simulator .app.tar.gz artifactgha-ios-composite-action.md
Need CI Android emulator .apk artifactgha-android-composite-action.md
Need one workflow to trigger both platform jobsgha-workflow-and-downloads.md
Need scripted artifact downloadgha-workflow-and-downloads.md

Source Inspiration

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

agent-device

Automates interactions for Apple-platform apps (iOS, tvOS, macOS) and Android devices. Use when navigating apps, taking snapshots/screenshots, tapping, typing, scrolling, or extracting UI info across mobile, TV, and desktop targets.

dogfood

Systematically explore and test a mobile app on iOS/Android with agent-device to find bugs, UX issues, and other problems. Use when asked to "dogfood", "QA", "exploratory test", "find issues", "bug hunt", or "test this app" on mobile. Produces a structured report with reproducible evidence: screenshots, optional repro videos, and detailed steps for every issue.

github

GitHub patterns using gh CLI for pull requests, stacked PRs, code review, branching strategies, and repository automation. Use when working with GitHub PRs, merging strategies, or repository management tasks.

react-native-best-practices

Provides React Native performance optimization guidelines for FPS, TTI, bundle size, memory leaks, re-renders, and animations. Applies to tasks involving Hermes optimization, JS thread blocking, bridge overhead, FlashList, native modules, or debugging jank and frame drops.

react-native-brownfield-migration

Provides an incremental adoption strategy to migrate native iOS or Android apps to React Native or Expo using @callstack/react-native-brownfield for initial setup. Use when planning migration steps, packaging XCFramework/AAR artifacts, and integrating them into host apps.

react-native-testing

Write tests using React Native Testing Library (RNTL) v13 and v14 (`@testing-library/react-native`). Use when writing, reviewing, or fixing React Native component tests. Covers: render, screen, queries (getBy/getAllBy/queryBy/findBy), Jest matchers, userEvent, fireEvent, waitFor, and async patterns. Supports v13 (React 18, sync render) and v14 (React 19+, async render). Triggers on: test files for React Native components, RNTL imports, mentions of "testing library", "write tests", "component tests", or "RNTL".

upgrading-react-native

Upgrades React Native apps to newer versions by applying rn-diff-purge template diffs, updating package.json dependencies, migrating native iOS and Android configuration, resolving CocoaPods and Gradle changes, and handling breaking API updates. Use when upgrading React Native, bumping RN version, updating from RN 0.x to 0.y, or migrating Expo SDK alongside a React Native upgrade.

validate-skills

Validates skills in this repo against agentskills.io spec and Claude Code best practices. Use via /validate-skills command.

vercel-react-native-skills

React Native and Expo best practices for building performant mobile apps. Use when building React Native components, optimizing list performance, implementing animations, or working with native modules. Triggers on tasks involving React Native, Expo, mobile performance, or native platform APIs.

関連スキル