Agent skill

Apple Mobile

by tellahq in tellahq/opensession

Build SwiftPM/xtool iOS apps and prepare explicitly approved ad-hoc or TestFlight releases through the apple-build and apple-release MCP servers.

MITAuto-check passedMobile

Install Apple Mobile

skills CLI
$ npx skills add tellahq/opensession --skill apple-mobile -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install tellahq/opensession apple-mobile --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/tellahq/opensession.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/apple-mobile .claude/skills/apple-mobile && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
apple-mobile
GitHub stars
392
Token cost
~781 tokens
SKILL.md length
397 words
Files
1
Skills in repo
15
Repo updated
First seen
Licence
MIT

At a glance

Build SwiftPM/xtool iOS apps and prepare explicitly approved ad-hoc or TestFlight releases through the apple-build and apple-release MCP servers.

  • Works in 6 steps: Run apple_mobile_doctor. → Run apple_mobile_inspect_project. → Run apple_mobile_test where the package… → …
  • Tasks that involve App store release
  • SKILL.md covers Safety rules, Development, Ad-hoc or TestFlight and Repository contract
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Apple Mobile is an agent skill from tellahq/opensession. Build SwiftPM/xtool iOS apps and prepare explicitly approved ad-hoc or TestFlight releases through the apple-build and apple-release MCP servers.

Its SKILL.md is about 780 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Mobile, covering App store release, iOS development and MCP servers. It works with App Store Connect, Model Context Protocol and Swift. The licence is MIT.

When your agent uses it

  • Tasks that involve App store release
  • Tasks that involve iOS development
  • Tasks that involve MCP servers

Example prompts

  • “/apple-mobile”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Run apple_mobile_doctor.
  2. Run apple_mobile_inspect_project.
  3. Run apple_mobile_test where the package has host-portable tests.
  4. Use apple_mobile_build_unsigned for a non-signing build.
  5. Inspect generated IPAs with apple_mobile_inspect_ipa.
  6. To show an app from a local Mac workspace, build an iphonesimulator .app

What it can do on your machine

Read from SKILL.md and the folder at commit 80702e8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Apple Mobile loads about 781 tokens when it runs. Until then it costs about 40 tokens; SKILL.md has 397 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~40
When it runs · the whole SKILL.md, loaded when a task matches
~781

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from tellahq/opensession at commit 80702e8, republished under its MIT licence (© tellahq). 397 words, ~781 tokens.

Download SKILL.mdSave it as .claude/skills/apple-mobile/SKILL.md (or your agent's skills folder).
name
apple-mobile
description
Build SwiftPM/xtool iOS apps and prepare explicitly approved ad-hoc or TestFlight releases through the apple-build and apple-release MCP servers.

Apple mobile workflow

Use apple_mobile_doctor and apple_mobile_inspect_project before any build.

Safety rules

  • Never paste or print an App Store Connect private key, Apple password, certificate private key, or provisioning secret.
  • Treat xtool as a development-build backend only. Do not claim its current development profiles are ad-hoc or App Store profiles.
  • Never release from a dirty worktree or an unapproved branch.
  • Never call apple_release_execute in the same response that creates a plan. Show the full project path, plan ID, commit, version/build, destination, effects, and any IPA filename and SHA-256. A signed-in allowed person must approve that exact pending plan later in Settings → Integrations → Apple mobile.
  • The execute confirmation must be the full commit SHA from the reviewed plan.
  • TestFlight upload is not App Review submission or public release. This integration deliberately exposes neither action.
  • Do not revoke certificates.

Development

  1. Run apple_mobile_doctor.
  2. Run apple_mobile_inspect_project.
  3. Run apple_mobile_test where the package has host-portable tests.
  4. Use apple_mobile_build_unsigned for a non-signing build.
  5. Inspect generated IPAs with apple_mobile_inspect_ipa.
  6. To show an app from a local Mac workspace, build an iphonesimulator .app inside the workspace and call opensession-portals start_simulator_portal with its workspace-relative appPath. This needs full Xcode and idb. Open the returned Portal at /, exercise the app, and report the URL. The person can pin it beside the conversation. A listening viewer may still be booting its simulator; verify the screen before claiming the app works. Use the returned name with restart_portal after rebuilding or stop_portal to release it. Restart creates a fresh device. This does not enable hot reload. See docs/simulator-portals.md in the Open Session repository.
Show full SKILL.md (132 more words)Show less

Ad-hoc or TestFlight

  1. Run apple_release_doctor and inspect the project.
  2. Create a plan using apple_release_plan_adhoc, apple_release_plan_testflight, or apple_release_plan_upload.
  3. Present the full project path, plan ID, commit, effects, and any IPA filename and SHA-256, then stop. The planning response cannot authorize execution.
  4. Ask a signed-in allowed person to approve the exact pending plan in Settings → Integrations → Apple mobile.
  5. In a later turn, call apple_release_execute with the plan ID and full planned commit SHA. The server consumes the one-time approval grant.
  6. Report the output artifact SHA-256 or upload result. Do not imply Apple processing has completed unless separately verified.

Repository contract

Each app must commit .opensession/apple-mobile.json. Configured paths are relative to the project and cannot escape it. Distribution operations require the xcode backend; xtool is intentionally rejected for distribution.

© tellahq, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/apple-mobile of tellahq/opensession.

Open the folder on GitHubat commit 80702e8

Compare with similar skills

Apple Mobile next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Apple Mobile compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Apple Mobile this skilltellahq/opensession392—~781Automated safety check: PassMIT
Releasemovieclaw/MovieClaw146—~2.6kAutomated safety check: PassCustom licence
AgentSquad for Swift2FastLabs/agent-squad7.8k—~3.5kAutomated safety check: PassApache-2.0
Asc Revenuecat Catalog Syncrorkai/app-store-connect-cli-skills1.1k3 repos~3.8kAutomated safety check: PassMIT
OdevioOdevio/Odevio-CLI423—~7.6kAutomated safety check: PassMIT
iOS App Store SubmitZestfulPulse/ios-app-store-submit142—~4.7kAutomated safety check: PassMIT

Similar skills

  • Release

    movieclaw/MovieClaw

    发布 movieclaw 新版本。当用户要求发版、发布新版本、打 tag、发布 NER 模型、发布 Docker 镜像,或打包上传 iOS App 到 TestFlight / App Store、补传发版附件(IPA、Mac 转码器、Mac 版 App)时使用。涵盖版本号三处同步、应用/模型/镜像/iOS 的完整流程、可选附件失败补救与检查清单。

    146 GitHub stars~2.6k tokensUpdated today
    MobileAuto-check passed
  • AgentSquad for Swift

    2FastLabs/agent-squad

    Guides building on-device multi-agent apps in Swift with the AgentSquad framework: which agent, orchestrator, classifier, storage or voice type fits each situation.

    7.8k GitHub stars~3.5k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed
  • Asc Revenuecat Catalog Sync

    rorkai/app-store-connect-cli-skills

    Reconcile App Store Connect subscriptions and in-app purchases with RevenueCat products, entitlements, offerings, and packages using asc and RevenueCat MCP.

    1.1k GitHub starsUsed in 3 repos~3.8k tokens
    MobileAuto-check passed
  • Odevio

    Odevio/Odevio-CLI

    Take a Flutter project to an iPhone or the App Store with Odevio - build, sign and publish iOS apps from Windows, Linux or macOS with no Mac and no Xcode.

    423 GitHub stars~7.6k tokensUpdated 14 days ago
    MobileAuto-check passed
  • iOS App Store Submit

    ZestfulPulse/ios-app-store-submit

    Build, sign, and submit a Flutter/iOS app to the App Store Connect — covers Xcode archive/export, code signing (including headless-Mac keychain workarounds), the asc CLI for App Store Connect…

    142 GitHub stars~4.7k tokensUpdated 7 days ago
    MobileAuto-check passed
  • Inspector MCP

    ipedro/Inspector

    A skill your agent uses when an agent needs to inspect a live iOS app through the Inspector MCP bridge, register or troubleshoot InspectorMCPServer for a consumer Xcode project, or query, resolve…

    170 GitHub stars~3.4k tokensUpdated 5 mo ago
    MobileAuto-check passed

More from tellahq/opensession

All 15 skills in this repo
  • Effect TS

    tellahq/opensession

    Write idiomatic Effect v4 TypeScript verified against the pinned effect@4.0.0-rc.112 source.

    392 GitHub stars~3.7k tokensUpdated yesterday
    Auto-check passed
  • Reflect

    tellahq/opensession

    Spawn three parallel review child sessions over the active transcript, surface learnings, and route each to a concrete edit on an existing skill.

    392 GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Show Me

    tellahq/opensession

    Help the user understand the current topic visually with concise diagrams, code-shape sketches, and focused HTML artifacts.

    392 GitHub stars~1.6k tokensUpdated yesterday
    Auto-check passed
  • Automate Me

    tellahq/opensession

    A skill your agent uses for "automate me", "create/update/refresh my -mode skill", "turn/capture my preferences or working style into a skill", or wanting agents to follow how the user works.

    392 GitHub stars~1.9k tokensUpdated yesterday
    Auto-check passed
  • PR Autofix

    tellahq/opensession

    Auto-fix a PR — address ALL reviewers' open feedback + failing CI, push, and reply in each addressed thread with honest attribution

    392 GitHub stars~1.5k tokensUpdated yesterday
    Auto-check passed
  • Swarm

    tellahq/opensession

    Fan out N parallel workers, drain them, and return one report.

    392 GitHub stars~609 tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Apple Mobile

What does Apple Mobile do?

Build SwiftPM/xtool iOS apps and prepare explicitly approved ad-hoc or TestFlight releases through the apple-build and apple-release MCP servers. Apple Mobile is an agent skill from tellahq/opensession. Build SwiftPM/xtool iOS apps and prepare explicitly approved ad-hoc or TestFlight releases through the apple-build and apple-release MCP servers.

When should I use Apple Mobile?

Apple Mobile fits situations like: tasks that involve App store release; tasks that involve iOS development; tasks that involve MCP servers.

How do I install Apple Mobile in Claude Code?

Run `npx skills add tellahq/opensession --skill apple-mobile -a claude-code`. Or copy the skill folder (.agents/skills/apple-mobile in tellahq/opensession) into .claude/skills/apple-mobile in your project. Claude Code loads it when a task matches its description.

How do I install Apple Mobile in Codex?

Run `npx skills add tellahq/opensession --skill apple-mobile -a codex`. Or copy the skill folder (.agents/skills/apple-mobile in tellahq/opensession) into .agents/skills/apple-mobile in your project. Codex loads it when a task matches its description.

Can I use Apple Mobile in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add tellahq/opensession --skill apple-mobile -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/apple-mobile, .gemini/skills/apple-mobile, .github/skills/apple-mobile and .opencode/skills/apple-mobile in your project.

What does Apple Mobile need to run?

SKILL.md names no scripts, command-line tools or credentials: Apple Mobile is instructions for the agent only.

Does Apple Mobile access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Apple Mobile safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Apple Mobile use?

Apple Mobile is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Apple Mobile use?

About 781 tokens (SKILL.md is roughly 3.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Apple Mobile?

Skills that share tags, products or a category with Apple Mobile: Release (movieclaw/MovieClaw, 146 stars), AgentSquad for Swift (2FastLabs/agent-squad, 7.8k stars), Asc Revenuecat Catalog Sync (rorkai/app-store-connect-cli-skills, 1.1k stars) and Odevio (Odevio/Odevio-CLI, 423 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Apple Mobile?

tellahq (a GitHub organization) maintains it in tellahq/opensession, which has 392 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on October 7, 2026.

Source: tellahq/opensession on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.