# Assets (Staging)

This folder stages non-guide assets for a future migration to a dedicated distribution repo.

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.

## 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 (All Assets)
This installs skills, agents, and instructions without cloning. Set the base URL once and reuse it. If your host needs a token, put it in one place.

```bash
export ASSETS_TOKEN="<token-if-needed>"
export ASSETS_BASE_URL="https://<host>/org/ai-assets/raw/main/assets"

curl -fsSL -H "Authorization: Bearer $ASSETS_TOKEN" \
	"$ASSETS_BASE_URL/sync-skills.sh" -o /tmp/sync-skills.sh
curl -fsSL -H "Authorization: Bearer $ASSETS_TOKEN" \
	"$ASSETS_BASE_URL/ios-skills.yaml" -o /tmp/ios-skills.yaml

chmod +x /tmp/sync-skills.sh
SKILLS_FILE=/tmp/ios-skills.yaml /tmp/sync-skills.sh

mkdir -p ~/.agents/agents ./instructions
curl -fsSL -H "Authorization: Bearer $ASSETS_TOKEN" \
	"$ASSETS_BASE_URL/agents/<agent-file>.agent.md" -o ~/.agents/agents/<agent-file>.agent.md
curl -fsSL -H "Authorization: Bearer $ASSETS_TOKEN" \
	"$ASSETS_BASE_URL/instructions/<name>.instructions.md" -o ./instructions/<name>.instructions.md
```

Notes:
- The token and base URL are only defined once.
- Remove the Authorization header if your host does not require it.
- Cloning the repo is still recommended if you want updates and version history.

## Install Agents (Clone And Copy)
Agents are prompt files that live under assets/agents.

```bash
git clone git@<host>:org/ai-assets.git
mkdir -p ~/.agents/agents
cp -R ai-assets/agents/* ~/.agents/agents/
```

## Install Instructions (Clone And Copy)
Instructions are repo-level rule files. Copy them into your project.

```bash
git clone git@<host>:org/ai-assets.git
mkdir -p ./instructions
cp -R ai-assets/instructions/* ./instructions/
```