ai-docs/assets/README.md
Matt Bruce 086c63bf21 refactor: auto-discover agents/instructions, replace YAML with plain text
- 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
2026-02-11 12:06:13 -06:00

3.0 KiB

AI Assets

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

Quick Start

Cloned Repo

# 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.

# 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