testflight

Automate iOS app deployment to TestFlight with version bumping and uploads.

Updated May 16, 2026
One-click install
npx skills add https://github.com/aryaxt/aryaxt-skills --skill testflight
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: testflight
Source: https://github.com/aryaxt/aryaxt-skills/tree/main/skills/testflight
Command: npx skills add https://github.com/aryaxt/aryaxt-skills --skill testflight

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires xcodebuild, altool, github-cli, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the deployment of an iOS app to TestFlight, ensuring that the latest build is made available to beta testers efficiently.

Core Features & Use Cases

  • Automated Deployment: Streamlines the process of archiving, exporting, and uploading the iOS app to TestFlight.
  • Prerequisites Check: Verifies all necessary conditions are met before proceeding with the deployment.
  • Build Synchronization: Ensures the latest code from the 'main' branch is used for the deployment.
  • Version Bumping: Automatically increments the build number for accurate version tracking.
  • Archive and Export: Generates the IPA file for iOS and, if applicable, the Mac Catalyst .pkg file for macOS.
  • Upload to TestFlight: Uploads the app to TestFlight and submits it for beta review.
  • GitHub Release Tagging: Creates a GitHub release tag and annotated commit to mark the build version.
  • User Notification: Informs the user of the successful deployment and any issues encountered.

Quick Start

Deploy the latest build to TestFlight by running the testflight skill.

Frequently Asked Questions about testflight

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate iOS app deployment to TestFlight?

Automating iOS app deployment to TestFlight involves synchronizing the main branch, bumping the build version, archiving the project, exporting the IPA, and uploading it. This skill handles that entire process end-to-end using xcodebuild and altool.

What's the best way to sync my main branch before archiving an iOS app for beta testing?

Syncing the main branch before archiving for beta testing ensures the latest code is deployed. This skill automatically synchronizes the main branch via GitHub CLI before proceeding with the build version increment and archiving steps.

Does this iOS deployment process handle Mac Catalyst builds for macOS?

Yes, the iOS deployment process handles Mac Catalyst builds for macOS. Alongside generating the iOS IPA file, the skill archives and exports a Mac Catalyst .pkg file if applicable, uploading both to TestFlight.

Do I need GitHub CLI to upload an iOS app to TestFlight?

Yes, GitHub CLI is required to upload an iOS app to TestFlight using this skill. It is used alongside xcodebuild and altool to synchronize branches and create GitHub release tags with annotated commits marking the build version.

How does version bumping work when deploying to TestFlight?

Version bumping when deploying to TestFlight automatically increments the build number for accurate version tracking. The skill then creates a GitHub release tag and an annotated commit to mark the newly deployed build version.

Can I automatically create a GitHub release tag after a TestFlight upload?

Yes, you can automatically create a GitHub release tag after a TestFlight upload. The skill generates an annotated commit and a GitHub release tag to mark the build version once the IPA and Mac Catalyst .pkg files are successfully uploaded.