ai-docs/assets
Matt Bruce 88e4402d38 fix: use tool-agnostic ~/.agents/ as default install path
Copilot, Claude, Cursor, and others all read from ~/.agents/.
The npx skills CLI handles fan-out to tool-specific directories.
2026-02-11 12:13:20 -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 fix: use tool-agnostic ~/.agents/ as default install path 2026-02-11 12:13:20 -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 fix: use tool-agnostic ~/.agents/ as default install path 2026-02-11 12:13:20 -06:00
setup.sh fix: use tool-agnostic ~/.agents/ as default install path 2026-02-11 12:13:20 -06:00
shared-skills.txt refactor: auto-discover agents/instructions, replace YAML with plain text 2026-02-11 12:06:13 -06:00

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 ~/.agents/skills/ SKILLS_DIR
Agents ~/.agents/agents/ AGENTS_DIR
Instructions ./instructions/ INSTRUCTIONS_DIR

The ~/.agents/ directory is tool-agnostic. Copilot, Claude, Cursor, and others all read from it. If you need a tool-specific path, override with the env var.

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