# Send TestFlight to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "testflight",
    "name": "TestFlight",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/ivangdavila/testflight",
    "canonicalUrl": "https://clawhub.ai/ivangdavila/testflight",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/testflight",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=testflight",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "ci-cd.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "testflight",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-01T12:59:20.155Z",
      "expiresAt": "2026-05-08T12:59:20.155Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=testflight",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=testflight",
        "contentDisposition": "attachment; filename=\"testflight-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "testflight"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/testflight"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/testflight",
    "downloadUrl": "https://openagent3.xyz/downloads/testflight",
    "agentUrl": "https://openagent3.xyz/skills/testflight/agent",
    "manifestUrl": "https://openagent3.xyz/skills/testflight/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/testflight/agent.md"
  }
}
```
## Documentation

### When to Use

User needs to distribute beta builds via TestFlight. Agent handles App Store Connect setup, tester groups, build uploads, and CI/CD integration.

### Quick Reference

TopicFileCI/CD automationci-cd.md

### 1. App Store Connect Setup First

Before uploading:

Bundle ID registered in Developer Portal
App created in App Store Connect
App-specific password or API key configured

### 2. Build Requirements

Every TestFlight build needs:

Unique build number (CFBundleVersion) - increment ALWAYS
Valid provisioning profile (App Store distribution)
No missing compliance declarations

### 3. Tester Group Strategy

GroupPurposeLimitInternalTeam members with App Store Connect access100ExternalBeta testers, requires review10,000

Internal builds available immediately. External requires Apple review (24-48h first time).

### 4. Upload Methods

MethodBest ForXcodeManual, one-off uploadsxcrun altoolScripts, CI without fastlaneFastlaneFull automation, multiple appsXcode CloudApple-native CI/CDTransporterGUI for non-developers

### 5. Build Expiration

TestFlight builds expire after 90 days. Plan releases accordingly.

### TestFlight Traps

Build number not incremented - rejected immediately, must bump and rebuild
Missing export compliance - stuck in "Processing" until answered in App Store Connect
External testers on first build - requires full beta review, use internal first
Expired provisioning profile - upload fails silently, check before archiving
App-specific password in CI - use App Store Connect API key instead (more secure, no 2FA issues)

### App Store Connect API Key (Recommended)

App Store Connect > Users > Keys > App Store Connect API
Generate key with "App Manager" role
Download .p8 file (only shown ONCE)
Note: Issuer ID, Key ID

### Fastlane Upload

# In Fastfile
lane :beta do
  build_app(scheme: "MyApp")
  upload_to_testflight(
    api_key_path: "fastlane/api_key.json",
    skip_waiting_for_build_processing: true
  )
end

### xcrun altool (No Fastlane)

xcrun altool --upload-app \\
  --type ios \\
  --file "MyApp.ipa" \\
  --apiKey "KEY_ID" \\
  --apiIssuer "ISSUER_ID"

### Security & Privacy

Data that leaves your machine:

IPA/app binary uploaded to Apple servers
Build metadata (version, bundle ID, team)

Data that stays local:

API keys and certificates (keep in Keychain)
Source code (not uploaded)

This skill does NOT:

Store Apple credentials in plain text
Share builds outside Apple's infrastructure

### Related Skills

Install with clawhub install <slug> if user confirms:

ios — iOS development patterns
xcode — Xcode workflows
flutter — cross-platform builds

### Feedback

If useful: clawhub star testflight
Stay updated: clawhub sync
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: ivangdavila
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-01T12:59:20.155Z
- Expires at: 2026-05-08T12:59:20.155Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/testflight)
- [Send to Agent page](https://openagent3.xyz/skills/testflight/agent)
- [JSON manifest](https://openagent3.xyz/skills/testflight/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/testflight/agent.md)
- [Download page](https://openagent3.xyz/downloads/testflight)