From 648ee9a8c92fe93d12bae2bc644d583eb5a8a98f Mon Sep 17 00:00:00 2001
From: Matt Bruce <matt.bruce1@toyota.com>
Date: Wed, 11 Feb 2026 11:37:29 -0600
Subject: [PATCH] docs: move skills sync into assets

---
 Agents.md                          |  4 ++--
 assets/README.md                   |  1 +
 {scripts => assets}/sync-skills.sh |  5 +++--
 docs/ai/skills.md                  | 20 ++++++++++++++------
 skills.yaml                        |  8 --------
 5 files changed, 20 insertions(+), 18 deletions(-)
 rename {scripts => assets}/sync-skills.sh (78%)
 delete mode 100644 skills.yaml

diff --git a/Agents.md b/Agents.md
index eac11a8..f26f7f3 100644
--- a/Agents.md
+++ b/Agents.md
@@ -75,8 +75,8 @@ If you update any file in this repo, commit and push right away so other develop
 ## Skills Sync
 This repo uses a skills manifest to standardize skills across developers.
 
-1. Review skills.yaml for the approved install list.
-2. Run ./scripts/sync-skills.sh (uses the `npx skills` CLI).
+1. Review the curated list under assets/.
+2. Run ./assets/sync-skills.sh (uses the `npx skills` CLI).
 3. Restart your editor if needed.
 
 ## Suggested Agent Request Template
diff --git a/assets/README.md b/assets/README.md
index 20d8aa5..f4a9482 100644
--- a/assets/README.md
+++ b/assets/README.md
@@ -6,5 +6,6 @@ Contents:
 - agents/: Agent prompt files
 - instructions/: Repo-level instruction files
 - 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
diff --git a/scripts/sync-skills.sh b/assets/sync-skills.sh
similarity index 78%
rename from scripts/sync-skills.sh
rename to assets/sync-skills.sh
index c5070f7..565d8da 100644
--- a/scripts/sync-skills.sh
+++ b/assets/sync-skills.sh
@@ -2,7 +2,8 @@
 set -euo pipefail
 
 ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-MANIFEST="$ROOT_DIR/skills.yaml"
+MANIFEST_DEFAULT="$ROOT_DIR/assets/shared-skills.yaml"
+MANIFEST="${SKILLS_FILE:-$MANIFEST_DEFAULT}"
 
 if [[ ! -f "$MANIFEST" ]]; then
   echo "Missing skills manifest: $MANIFEST" >&2
@@ -12,7 +13,7 @@ fi
 INSTALLS=$(sed -n 's/^[[:space:]]*install:[[:space:]]*//p' "$MANIFEST" | sed 's/^"//;s/"$//')
 
 if [[ -z "$INSTALLS" ]]; then
-  echo "No install entries found in skills.yaml" >&2
+  echo "No install entries found in: $MANIFEST" >&2
   exit 1
 fi
 
diff --git a/docs/ai/skills.md b/docs/ai/skills.md
index 547efce..af1a8e3 100644
--- a/docs/ai/skills.md
+++ b/docs/ai/skills.md
@@ -67,17 +67,25 @@ skills:
 ```
 
 ### Sync Workflow
-1. Run the sync script.
-2. The script installs each skill using the `npx skills` CLI.
+1. Update the curated list in assets (shared, iOS, or Android).
+2. Run the sync script.
+3. The script installs each skill using the `npx skills` CLI.
 3. Restart your editor if required.
 
 ### Example Sync Command
 ```bash
-./scripts/sync-skills.sh
+./assets/sync-skills.sh
+```
+
+### Platform-Specific Install
+Set `SKILLS_FILE` to install a platform list:
+
+```bash
+SKILLS_FILE=./assets/ios-skills.yaml ./assets/sync-skills.sh
 ```
 
 ## Skills CLI (Single Path)
-We use a single, approved path: update skills.yaml and run the sync script. The sync script calls `npx skills add` for each entry.
+We use a single, approved path: update the curated list under assets/ and run the sync script. The sync script calls `npx skills add` for each entry.
 
 ### Where To Find Skills
 - Homepage: https://skills.sh/
@@ -85,8 +93,8 @@ We use a single, approved path: update skills.yaml and run the sync script. The
 - CLI reference: https://skills.sh/docs/cli
 
 ### How It Works (High-Level)
-1. You update skills.yaml with the approved install entries.
-2. Run ./scripts/sync-skills.sh.
+1. You update assets/shared-skills.yaml (or a platform list) with approved install entries.
+2. Run ./assets/sync-skills.sh.
 3. The script uses `npx skills` to install each skill.
 
 ### Install The CLI (No Global Install Required)
diff --git a/skills.yaml b/skills.yaml
deleted file mode 100644
index ca13003..0000000
--- a/skills.yaml
+++ /dev/null
@@ -1,8 +0,0 @@
-version: 1
-skills:
-  - name: swiftui-expert-skill
-    install: "https://github.com/avdlee/swiftui-agent-skill --skill swiftui-expert-skill"
-  - name: onboarding-cro
-    install: "vercel-labs/agent-skills"
-  - name: webapp-testing
-    install: "vercel-labs/agent-skills"