docs: move skills sync into assets

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

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.

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
 

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)

skills.yaml

@@ -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"