testflight
Skill14 starsChanged 11 days agoMITView on GitHub
Automatically publish a Baton iOS TestFlight build, create or reuse a PR from release/testflight, merge after required checks pass, and delete the branch after merge. Use the macOS release script or Xcode Cloud on Linux. Check readiness without publishing when the user only asks a question.
2 other projects use a version of this.
Adopted by
Most recently taken up by
- everpcpc/KMReadertheir own version, first seen Oct 8, 2026
- Sassy-Dog/skillstheir own version, first seen Oct 8, 2026
Other versions2 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 2
- everpcpc/KMReader★ 118same name
- Sassy-Dog/skills★ 1same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
The file
We split this skill into the rules it gives an agent
8 rules. About 0 are common, 3 are distinctive, and 5 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
Distinctive · estimate
This author's own choices. Worth a look.
5
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- could be automatic: a setting could enforce it
- Very specific: line 8
Follow .claude/commands/testflight.md.
- Distinctive: line 25
Do not create a new branch for each build number or force-push this branch.
- Very specific: line 27
Run node scripts/release-ios-cloud.mjs --dry-run as a preflight, then run npm run release:ios:cloud on that same branch in the same …
- Very specific: line 34
If a protected-branch push fails after the script creates its bump commit, preserve that commit.
- Distinctive: line 47
If creating an Xcode Cloud run returns an unexplained HTTP 500, first remind the user to check for an updated Apple Developer Program …
- Very specific: line 52
Wait until the TestFlight upload finishes, App Store Connect marks the build VALID, and the internal Test group is IN_BETA_TESTING.
- Distinctive: line 57
Wait for its required CI checks and repository review requirements, resolve relevant failures within the release scope, and merge …
- Very specific: line 65
After confirming the PR is merged, delete release/testflight remotely and locally.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Baton TestFlight
Follow .claude/commands/testflight.md. A request to publish authorizes the
release's source commits, branch creation, pushes, build-number bump, cloud run,
TestFlight group assignment, the PR and merge after a successful release,
and deletion of the release branch after the merge is confirmed.
Perform these steps without asking for additional approval. Before publishing,
inspect git status --short, including untracked
files. Commit changes within the requested release scope automatically;
preserve unrelated work, using an isolated checkout when needed.
On macOS, run npm run release:ios.
On Linux, publish from the fixed, unprotected release/testflight branch,
not main:
- Reuse
release/testflightfor every release. Fetch and merge the latestorigin/maininto it while preserving its release commits. If it does not exist, create it from the prepared release commit or latestorigin/main. Do not create a new branch for each build number or force-push this branch. - Push the release source commit to Xcode Cloud's connected GitHub repository.
Run
node scripts/release-ios-cloud.mjs --dry-runas a preflight, then runnpm run release:ios:cloudon that same branch in the same invocation. The cloud script commits and pushes its build-number bump before starting Xcode Cloud; a protected branch would reject that push. - Finish and verify the release before the automatic PR workflow below. Preserve branch protection.
If a protected-branch push fails after the script creates its bump commit,
preserve that commit. Move it onto release/testflight automatically
and push the branch. Rerun the dry-run and release on
that branch; let the script decide whether the prepared build number is reusable
instead of manually bumping again. No cloud run starts when that push fails.
For readiness questions, only inspect state and use the dry-run on Linux. Report the final build number, cloud run ID, and upload status; include a PR URL only if one exists. The cloud script adds valid builds to the internal Test group; confirm that state before saying testers can install the build. If group assignment fails after upload, report the existing build instead of starting another release.
If creating an Xcode Cloud run returns an unexplained HTTP 500, first remind
the user to check for an updated Apple Developer Program License Agreement
awaiting acceptance. Follow the agreement check in
.claude/commands/testflight.md before further start attempts.
Wait until the TestFlight upload finishes, App Store Connect marks the build
VALID, and the internal Test group is IN_BETA_TESTING. Only then
automatically create or reuse a PR from the existing
release/testflight branch to main, including the build-number bump and
release changes. Do not create a temporary PR branch or ask for separate approval.
Wait for its required CI checks and repository review requirements, resolve
relevant failures within the release scope, and merge automatically when
allowed. Use the repository's supported merge method and never bypass branch
protection. Continue monitoring until the PR is actually merged and branch
cleanup below is complete; starting an upload, opening a PR, or enabling
auto-merge is not completion. Report the build number, upload and group status,
PR URL, and merge result. Do not merge a PR whose release failed.
After confirming the PR is merged, delete release/testflight remotely and
locally. If GitHub already deleted the remote branch, verify that it is gone.
Switch the working tree to main before deleting the local branch. Do not
restore the branch after merge; the next release recreates the same fixed
branch name from the latest origin/main. Keep the branch if publication or
merge fails so the release can be resumed.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

