From 99ebb26c2cd4478193d6e6970e0d6a184f1e2bf6 Mon Sep 17 00:00:00 2001
From: DIYgod <i@diygod.me>
Date: Sun, 15 Feb 2026 11:57:06 +0800
Subject: [PATCH] feat(skill): add iOS preview build install skill (#4851)

---
 .../installing-mobile-preview-builds/SKILL.md | 85 +++++++++++++++++++
 1 file changed, 85 insertions(+)
 create mode 100644 .claude/skills/installing-mobile-preview-builds/SKILL.md

diff --git a/.claude/skills/installing-mobile-preview-builds/SKILL.md b/.claude/skills/installing-mobile-preview-builds/SKILL.md
new file mode 100644
index 000000000..18dd6acab
--- /dev/null
+++ b/.claude/skills/installing-mobile-preview-builds/SKILL.md
@@ -0,0 +1,85 @@
+---
+name: installing-mobile-preview-builds
+description: Builds and installs the iOS preview build for apps/mobile using EAS and devicectl. Use when the user asks to install a preview/internal iOS build on a connected iPhone for production-like testing.
+disable-model-invocation: true
+allowed-tools: Bash, Read, Glob, Grep
+argument-hint: "[device-udid-or-name(optional)]"
+---
+
+# Install Mobile Preview Build (iOS)
+
+Use this skill to create a fresh `preview` iOS build and install it on a connected iPhone.
+
+## Inputs
+
+- Optional `$ARGUMENTS`: device identifier (UDID or exact device name).
+- If no argument is provided, auto-select the first paired iPhone from `xcrun devicectl list devices`.
+
+## Workflow
+
+1. Validate repo and tooling.
+   - Run from repo root and ensure `apps/mobile` exists.
+   - Verify `pnpm`, `xcrun`, and `eas-cli` are available.
+   - Verify EAS login:
+     ```bash
+     cd apps/mobile
+     pnpm dlx eas-cli whoami
+     ```
+2. Resolve target device.
+   - List paired devices:
+     ```bash
+     xcrun devicectl list devices
+     ```
+   - Choose device in this order:
+     - `$ARGUMENTS` if provided and matches exactly one device.
+     - Otherwise, first paired iPhone.
+3. Trigger `preview` iOS build.
+   ```bash
+   cd apps/mobile
+   pnpm dlx eas-cli build -p ios --profile preview --non-interactive
+   ```
+
+   - Capture build ID from output (URL suffix `/builds/<id>`).
+   - Poll until status becomes `FINISHED` or `ERRORED`:
+     ```bash
+     cd apps/mobile
+     pnpm dlx eas-cli build:view <build-id> --json
+     ```
+4. On success, resolve artifact URL.
+   - Use `artifacts.applicationArchiveUrl`.
+   - If absent, fallback to `artifacts.buildUrl`.
+5. Install to device locally.
+   ```bash
+   mkdir -p .context/preview-install
+   curl -fL "<ipa-url>" -o .context/preview-install/folo-preview.ipa
+   unzip -q -o .context/preview-install/folo-preview.ipa -d .context/preview-install/unpacked
+   APP_PATH=$(find .context/preview-install/unpacked/Payload -maxdepth 1 -name '*.app' -type d | head -n 1)
+   xcrun devicectl device install app --device "<device-id>" "$APP_PATH"
+   ```
+6. Try launching app.
+   ```bash
+   xcrun devicectl device process launch --device "<device-id>" is.follow --activate
+   ```
+
+   - If launch fails due to locked device, instruct the user to unlock iPhone and open `Folo` manually.
+
+## Failure Handling
+
+- If build status is `ERRORED`, report:
+  - build ID
+  - `error.message`
+  - build page URL
+- If app config fails with `Assets source directory not found ... /out/rn-web`, prebuild assets then retry once:
+  ```bash
+  pnpm --filter @follow/rn-micro-web-app build --outDir out/rn-web/html-renderer
+  ```
+
+## Output Format
+
+Always return:
+
+1. Build ID and final status.
+2. Build page URL and IPA URL.
+3. Target device identifier.
+4. Install result (`installed` or `failed`) and launch result.
+5. Next action for the user if manual action is required.