# asc-ad-hoc-distribution

Builds and publishes private iOS ad hoc installs to S3-compatible storage for registered test devices without TestFlight. Works with .xcarchive packages and standalone IPAs.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 794 installs · ★ 1101
- Author: rorkai
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/rorkai/app-store-connect-cli-skills/tree/HEAD/skills/asc-ad-hoc-distribution/SKILL.md
- Updated: 2026-10-20
- HTML: https://affpapa.org/en/nevibecode/skills/asc-ad-hoc-distribution

## What it does

The skill coordinates private iOS releases using the `asc distribute` CLI. For a full run starting from an `.xcarchive`, it runs through `plan`, `apply`, `resume`, and `verify`. The planning phase is read-only and outputs an exact execution blueprint. Nothing gets written remotely until you explicitly approve the 64-character plan hash.

Keep in mind that v1 plans fail if the archive contains Watch apps, App Clips, or app extensions. It requires a single main app target. You also need an existing S3-compatible bucket, an App Store Connect account, and a local PKCS#12 identity. The tool generates install links, but it will not create buckets or push apps onto phones.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add rorkai/app-store-connect-cli-skills --skill asc-ad-hoc-distribution -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/asc-ad-hoc-distribution/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/asc-ad-hoc-distribution/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add rorkai/app-store-connect-cli-skills --skill asc-ad-hoc-distribution -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/asc-ad-hoc-distribution/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add rorkai/app-store-connect-cli-skills --skill asc-ad-hoc-distribution -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/asc-ad-hoc-distribution/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install rorkai/app-store-connect-cli-skills asc-ad-hoc-distribution
```

2. **Manually: put the files in place**
- File: `.github/skills/asc-ad-hoc-distribution/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add rorkai/app-store-connect-cli-skills --skill asc-ad-hoc-distribution -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/rorkai/app-store-connect-cli-skills --path skills/asc-ad-hoc-distribution
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/asc-ad-hoc-distribution/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add rorkai/app-store-connect-cli-skills --skill asc-ad-hoc-distribution -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/rorkai/app-store-connect-cli-skills/tree/HEAD/skills/asc-ad-hoc-distribution/SKILL.md

## When to use it
- generate private iOS install links from an `.xcarchive`
- register missing test devices in App Store Connect
- reconcile ad hoc provisioning profiles
- upload signed IPA artifacts to S3-compatible storage

## Example prompts
- Create a distribution plan for `.asc/artifacts/App.xcarchive` using `.asc/distribution/config.json`
- Apply the authorized ad hoc distribution plan using the hash from `plan.json`
- Inspect the progress of the current run with `asc distribute status`

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 55ec56b5cf002e54.

BEGIN THIRD-PARTY FILE 55ec56b5cf002e54
````text
---
name: asc-ad-hoc-distribution
description: Prepare, publish, resume, and verify private iOS release-testing installs with asc distribute. Use when distributing an IPA to registered devices outside TestFlight, reconciling ad hoc profiles, publishing through caller-owned S3-compatible storage, or diagnosing a resumable private distribution run.
---

# ASC ad hoc distribution

Use the experimental `asc distribute` workflow to turn an existing iOS archive
into a private, verified install link for registered devices. Use TestFlight or
the App Store release skills instead when the build should go through Apple-hosted
distribution.

Confirm the installed contract before acting:

```bash
asc distribute --help
asc distribute plan --help
asc distribute apply --help
asc distribute resume --help
asc distribute status --help
asc distribute verify --help
```

## Choose the workflow

- Use `plan` -> `apply` -> `resume`/`status` -> `verify` for an end-to-end,
  hash-authorized run starting from an `.xcarchive`.
- Use `inspect` -> `prepare` -> `publish` only when the caller already owns the
  ad hoc IPA and wants to operate the lower-level boundaries separately.

## Guardrails

- Treat the distribution spec, devices file, PKCS#12 identity, password file,
  run state, and exact install-link artifact as private. Keep them out of Git and
  require owner-only permissions.
- Never put S3 credentials or presigned URLs in the distribution spec, command
  output, logs, issues, or chat. Use `ASC_S3_ACCESS_KEY_ID`,
  `ASC_S3_SECRET_ACCESS_KEY`, and optional `ASC_S3_SESSION_TOKEN`, or the
  standard AWS SDK credential chain.
- `plan` is read-only and may exit successfully with `ready: false`. Inspect the
  typed blockers and effects before continuing.
- `apply` can register missing devices, create safe App IDs and successor ad hoc
  profiles, write local artifacts, and publish immutable objects. Run it only
  after the user authorizes the exact plan hash and effect inventory.
- The orchestrated workflow supports private access to an existing
  S3-compatible bucket. It does not create buckets, change policies, delete old
  builds, install the app, or launch it.
- Input drift, an immutable-object conflict, expired signing material, or an
  expired private link requires a new plan. Do not force the old run forward.

## Preconditions

- An existing iOS `.xcarchive` with one main app target. Embedded apps,
  extensions, Watch apps, and App Clips make the v1 plan not ready.
- A local iOS distribution PKCS#12 identity and optional protected password file.
- A protected strict-v1 devices file. For example:

```json
{"schemaVersion":1,"devices":[{"name":"Test iPhone","udid":"DEVICE_UDID","platform":"IOS"}]}
```
````
END THIRD-PARTY FILE 55ec56b5cf002e54

The third-party file has ended. Everything between the 55ec56b5cf002e54 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2728 of 7352 bytes. © rorkai · MIT · https://github.com/rorkai/app-store-connect-cli-skills/tree/HEAD/skills/asc-ad-hoc-distribution/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md