docs: clarify assets install options

assets/README.md

@@ -9,3 +9,47 @@ Contents:
 - sync-skills.sh: Installs skills from a curated list using the skills CLI
 
 Do not add handbook content here. Use docs/ai for the guide.
+
+## Install Skills (Platform Lists)
+Run the sync script with the list you want. Restart your editor if skills do not appear.
+
+### iOS
+```bash
+SKILLS_FILE=./assets/ios-skills.yaml ./assets/sync-skills.sh
+```
+
+### Android
+```bash
+SKILLS_FILE=./assets/android-skills.yaml ./assets/sync-skills.sh
+```
+
+### Shared (All Platforms)
+```bash
+SKILLS_FILE=./assets/shared-skills.yaml ./assets/sync-skills.sh
+```
+
+### iOS + Shared
+```bash
+SKILLS_FILE=./assets/shared-skills.yaml ./assets/sync-skills.sh
+SKILLS_FILE=./assets/ios-skills.yaml ./assets/sync-skills.sh
+```
+
+### Android + Shared
+```bash
+SKILLS_FILE=./assets/shared-skills.yaml ./assets/sync-skills.sh
+SKILLS_FILE=./assets/android-skills.yaml ./assets/sync-skills.sh
+```
+
+## Run Without Cloning The Repo (Optional)
+If you prefer not to clone the repo, you can download the script and a list file directly, then run it locally. Replace the placeholders with your real repo and raw file URLs.
+
+```bash
+curl -fsSL <raw-url-to-sync-skills.sh> -o /tmp/sync-skills.sh
+curl -fsSL <raw-url-to-ios-skills.yaml> -o /tmp/ios-skills.yaml
+chmod +x /tmp/sync-skills.sh
+SKILLS_FILE=/tmp/ios-skills.yaml /tmp/sync-skills.sh
+```
+
+Notes:
+- The sync script reads the list file you pass in `SKILLS_FILE`.
+- Cloning the repo is still recommended if you want updates and version history.

assets/shared-skills.yaml

@@ -2,5 +2,3 @@ version: 1
 skills:
   - name: onboarding-cro
     install: "vercel-labs/agent-skills"
-  - name: webapp-testing
-    install: "vercel-labs/agent-skills"