086c63bf21
- Agents and instructions are now discovered automatically via directory scanning (local) or hosting API (remote) — no hardcoded list files - Replaced YAML skill manifests with plain text files (one install per line) - Deleted agents.list, instructions.list, and all *-skills.yaml files - Updated setup.sh to v2.0.0 with GitLab/GitHub API support - Updated all references in skills.md and README.md
97 lines
3.0 KiB
Markdown
97 lines
3.0 KiB
Markdown
# 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 | |