# AI Assets

One script installs everything. No cloning or manual copy/paste required.

## Quick Start

### Cloned Repo

```bash
# Install everything for iOS
./assets/setup.sh all ios

# Or pick what you need
./assets/setup.sh skills ios
./assets/setup.sh agents
./assets/setup.sh instructions
```

### No Clone (Run Remotely)

Point the script at the repo and run. Nothing to download first.

```bash
# Set the base URL once (get this from your team lead)
export ASSETS_BASE_URL="https://gitlab.com/<org>/mobile-ai-docs/-/raw/develop/assets"

# Install everything for iOS — one command
bash <(curl -fsSL "$ASSETS_BASE_URL/setup.sh") all ios

# Or pick what you need
bash <(curl -fsSL "$ASSETS_BASE_URL/setup.sh") skills ios
bash <(curl -fsSL "$ASSETS_BASE_URL/setup.sh") agents
bash <(curl -fsSL "$ASSETS_BASE_URL/setup.sh") instructions
```

That's it.

---

## Commands

| Command | What It Does |
|---------|-------------|
| `setup.sh skills [platform]` | Install skills from a curated list |
| `setup.sh agents` | Install all agent prompt files (auto-discovered) |
| `setup.sh instructions` | Install all instruction rule files (auto-discovered) |
| `setup.sh all [platform]` | All of the above in one shot |
| `setup.sh help` | Print usage |

### Platforms (for skills)

| Platform | List File |
|----------|-----------|
| `ios` | ios-skills.txt |
| `android` | android-skills.txt |
| `shared` (default) | shared-skills.txt |

## Where Things Get Installed

| Asset | Default Location | Override |
|-------|-----------------|----------|
| Skills | Managed by `npx skills` CLI | — |
| Agents | `~/.copilot/agents/` | `AGENTS_DIR` |
| Instructions | `./instructions/` | `INSTRUCTIONS_DIR` |

## Adding New Assets

- **Agents or instructions** — Drop the file into `assets/agents/` or `assets/instructions/` and push. The script discovers files from the directory automatically. No manifest to update.
- **Skills** — Add the install command to the appropriate `.txt` file (e.g., `ios-skills.txt`). One command per line.

## How It Works

| Mode | Agents / Instructions | Skills |
|------|----------------------|--------|
| **Local** (cloned repo) | `find` scans the directory | Reads the `.txt` file |
| **Remote** (no clone) | Queries GitLab/GitHub API to list files | Downloads the `.txt` file |

## Folder Structure

```
assets/
  setup.sh                  ← the installer
  ios-skills.txt            ← curated iOS skills (one per line)
  android-skills.txt        ← curated Android skills
  shared-skills.txt         ← curated cross-platform skills
  agents/                   ← agent prompt files (auto-discovered)
  instructions/             ← instruction rule files (auto-discovered)
```

## Environment Variables

| Variable | Purpose | Required? |
|----------|---------|-----------|
| `ASSETS_BASE_URL` | Base URL for remote downloads | Only without a clone |
| `AGENTS_DIR` | Custom agents install path | No |
| `INSTRUCTIONS_DIR` | Custom instructions install path | No |
| `REPO_TOKEN` | Auth token for private repos | Only if API rejects |