deonmenezes/mobile-app-skill / skills/app-store-release
app-store-release
UnverifiedShip an iOS app update or a first release to the App Store end to end, the way it is actually done across many real releases. Bumps the version, builds and signs on a Mac over SSH (or on a GitHub-hosted Mac when yours is asleep), uploads, waits for processing, submits for App Review, watches the review, handles rejections and hotfixes, and checks the app is really on sale afterwards. Includes its own scripts for Windows, Linux and macOS (what has and has not been exercised is listed in the skill), and a one-time setup interview so later releases need no questions. Use when the user says "ship it", "release an update", "push a new version", "submit to the App Store", "upload to TestFlight", "resubmit", "replace the build in review", "my app got rejected", "hotfix", "why is my approved app not on the store", or "set up release automation".
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 16.9 KB |
| references/build-hosts.md | markdown | 8.8 KB |
| references/first-release.md | markdown | 6.0 KB |
| references/gotchas.md | markdown | 11.7 KB |
| references/rejections.md | markdown | 4.9 KB |
| references/setup.md | markdown | 6.5 KB |
| scripts/asc_api.py | script | 7.7 KB |
| scripts/asc_availability.py | script | 3.3 KB |
| scripts/asc_status.py | script | 9.7 KB |
| scripts/asc_submit.py | script | 28.3 KB |
| scripts/fetch_profiles.py | script | 4.1 KB |
| scripts/mac_release.shexecutable | script | 12.6 KB |
| scripts/manual_sign.py | script | 3.0 KB |
| scripts/release_config.py | script | 12.1 KB |
| scripts/upload_ipa.py | script | 5.7 KB |
| templates/ios-release.yml | config | 4.2 KB |
scripts/fetch_profiles.py
View on GitHub#!/usr/bin/env python3
"""Download App Store provisioning profiles by name, so a build host needs no profile files of its own.
python fetch_profiles.py --out profiles "My App AppStore" "My App Widget AppStore"
python fetch_profiles.py --list every profile the key can see, with its team and bundle id
python fetch_profiles.py --profile clientteam --out profiles "Client App AppStore"
Each profile is saved as <uuid>.mobileprovision, the file name Xcode expects. Copy them into BOTH
~/Library/Developer/Xcode/UserData/Provisioning Profiles/ (Xcode 16 and later)
~/Library/MobileDevice/Provisioning Profiles/ (older Xcode)
mac_release.sh does that when PROFILE_DIR points at the folder.
A profile is a snapshot: after changing an App ID's capabilities or App Groups, regenerate the profile in the
developer portal and fetch it again. The check below prints the App Groups each profile really carries.
Exit codes: 0 ok, 2 a named profile was not found or is not active, 4 API error.
"""
import base64
import plistlib
import re
import sys
from pathlib import Path
sys.path.insert(0, str(Path(__file__).parent))
from asc_api import Api, ApiError # noqa: E402
def embedded_plist(raw):
"""The plist inside the CMS-signed profile."""
m = re.search(rb"<\?xml.*?</plist>", raw, re.S)
return plistlib.loads(m.group(0)) if m else {}
def main(argv):
profile = None
if "--profile" in argv:
i = argv.index("--profile")
profile = argv[i + 1]
del argv[i:i + 2]
out = Path(".")
if "--out" in argv:
i = argv.index("--out")
out = Path(argv[i + 1])
del argv[i:i + 2]
names = [a for a in argv if not a.startswith("--")]
sys.stdout.reconfigure(encoding="utf-8")
api = Api(profile)
fields = "fields[profiles]=name,uuid,profileState,profileType,expirationDate,profileContent"
if "--list" in argv:
url = ("/v1/profiles?limit=200&fields[profiles]=name,profileState,profileType,expirationDate,bundleId"
"&include=bundleId&fields[bundleIds]=identifier,seedId")
while url:
page = api.get(url)
bundles = {i["id"]: i["attributes"] for i in page.get("included", [])}
for p in page["data"]:
a = p["attributes"]
b = bundles.get(((p["relationships"].get("bundleId") or {}).get("data") or {}).get("id"), {})
print(f"{a['profileState']:<8} {a['profileType']:<18} expires {a['expirationDate'][:10]} "
f"team {b.get('seedId', '?'):<10} {b.get('identifier', '?'):<40} {a['name']}")
url = (page.get("links") or {}).get("next")
return
if not names:
sys.exit(__doc__)
out.mkdir(parents=True, exist_ok=True)
missing = False
for name in names:
found = [p for p in api.get_all(f"/v1/profiles?filter[name]={name.replace(' ', '%20')}&limit=200&{fields}")
if p["attributes"]["name"] == name]
active = [p for p in found if p["attributes"]["profileState"] == "ACTIVE"]
if not active:
print(f"MISSING {name}: " + ("found but not ACTIVE (expired or invalidated)" if found else "no profile with this exact name"))
missing = True
continue
# Several profiles can share one name; take the one that expires last.
p = max(active, key=lambda x: x["attributes"]["expirationDate"])["attributes"]
raw = base64.b64decode(p["profileContent"])
(out / f"{p['uuid']}.mobileprovision").write_bytes(raw)
ent = embedded_plist(raw).get("Entitlements", {})
groups = ent.get("com.apple.security.application-groups", [])
note = f" ({len(active)} active profiles share this name)" if len(active) > 1 else ""
print(f"SAVED {name} -> {p['uuid']}.mobileprovision {ent.get('application-identifier', '?')} "
f"expires {p['expirationDate'][:10]} app groups: {', '.join(groups) or 'none'}{note}")
sys.exit(2 if missing else 0)
if __name__ == "__main__":
try:
main(sys.argv[1:])
except ApiError as e:
print(e.describe())
sys.exit(4)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |