History

Matt Bruce 20446c5224 feat: auto-discover custom skills from assets/skills/ - setup.sh skills command now does two things: 1. Installs registry skills from <platform>-skills.txt 2. Auto-discovers and copies custom skill folders from assets/skills/ - Added SKILLS_DIR config (default: ~/.copilot/skills/) - Added download_dir_to helper for copying skill folders remotely - Created assets/skills/ for team-maintained custom skills		2026-02-11 12:11:01 -06:00
..
agents	chore: move agents and instructions to assets	2026-02-11 10:24:50 -06:00
instructions	chore: move agents and instructions to assets	2026-02-11 10:24:50 -06:00
skills	feat: auto-discover custom skills from assets/skills/	2026-02-11 12:11:01 -06:00
android-skills.txt	refactor: auto-discover agents/instructions, replace YAML with plain text	2026-02-11 12:06:13 -06:00
ios-skills.txt	docs: note both registry and URL formats in skills files	2026-02-11 12:08:12 -06:00
README.md	feat: auto-discover custom skills from assets/skills/	2026-02-11 12:11:01 -06:00
setup.sh	feat: auto-discover custom skills from assets/skills/	2026-02-11 12:11:01 -06:00
shared-skills.txt	refactor: auto-discover agents/instructions, replace YAML with plain text	2026-02-11 12:06:13 -06:00

README.md

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 registry skills + custom skills (auto-discovered)
`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
Registry skills	Managed by `npx skills` CLI	—
Custom skills	`~/.copilot/skills/`	`SKILLS_DIR`
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. Auto-discovered.
Custom skills — Add a folder with a SKILL.md to assets/skills/ and push. Auto-discovered.
Registry skills — Add the install entry to the appropriate .txt file (e.g., ios-skills.txt). One per line.

How It Works

Mode	Agents / Instructions / Custom Skills	Registry 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
  skills/                   ← custom skill folders (auto-discovered)
    my-skill/
      SKILL.md
  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
`REPO_TOKEN`	Auth token for private repos	Only if API rejects