From 399737006fed31613e3ea59cf365dd1ad27069e8 Mon Sep 17 00:00:00 2001
From: Matt Bruce <matt.bruce1@toyota.com>
Date: Wed, 11 Feb 2026 11:43:59 -0600
Subject: [PATCH] docs: clarify assets install options

---
 assets/README.md          | 46 ++++++++++++++++++++++++++++++++++++++-
 assets/shared-skills.yaml |  2 --
 2 files changed, 45 insertions(+), 3 deletions(-)

diff --git a/assets/README.md b/assets/README.md
index f4a9482..4333144 100644
--- a/assets/README.md
+++ b/assets/README.md
@@ -8,4 +8,48 @@ Contents:
 - ios-skills.yaml, android-skills.yaml, shared-skills.yaml: Curated skills lists
 - 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.
\ No newline at end of file
+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.
\ No newline at end of file
diff --git a/assets/shared-skills.yaml b/assets/shared-skills.yaml
index 9e3f868..a3ded81 100644
--- a/assets/shared-skills.yaml
+++ b/assets/shared-skills.yaml
@@ -1,6 +1,4 @@
 version: 1
 skills:
   - name: onboarding-cro
-    install: "vercel-labs/agent-skills"
-  - name: webapp-testing
     install: "vercel-labs/agent-skills"
\ No newline at end of file