ai-docs/assets

Assets (Staging)

This folder stages non-guide assets for a future migration to a dedicated distribution repo.

Contents:

• agents/: Agent prompt files
• instructions/: Repo-level instruction files
• ios-skills.yaml, android-skills.yaml, shared-skills.yaml: Curated skills lists
• sync-skills.sh: Installs skills from a curated list using the skills CLI

Do not add handbook content here. Use docs/ai for the guide.

Install Skills (Platform Lists)

Run the sync script with the list you want. Restart your editor if skills do not appear.

iOS

SKILLS_FILE=./assets/ios-skills.yaml ./assets/sync-skills.sh

Android

SKILLS_FILE=./assets/android-skills.yaml ./assets/sync-skills.sh

Shared (All Platforms)

SKILLS_FILE=./assets/shared-skills.yaml ./assets/sync-skills.sh

iOS + Shared

SKILLS_FILE=./assets/shared-skills.yaml ./assets/sync-skills.sh
SKILLS_FILE=./assets/ios-skills.yaml ./assets/sync-skills.sh

Android + Shared

SKILLS_FILE=./assets/shared-skills.yaml ./assets/sync-skills.sh
SKILLS_FILE=./assets/android-skills.yaml ./assets/sync-skills.sh

Run Without Cloning The Repo (All Assets)

This installs skills, agents, and instructions without cloning. Set the base URL once and reuse it.

export ASSETS_BASE_URL="https://<host>/org/ai-assets/raw/main/assets"

curl -fsSL "$ASSETS_BASE_URL/sync-skills.sh" -o /tmp/sync-skills.sh
curl -fsSL "$ASSETS_BASE_URL/ios-skills.yaml" -o /tmp/ios-skills.yaml

chmod +x /tmp/sync-skills.sh
SKILLS_FILE=/tmp/ios-skills.yaml /tmp/sync-skills.sh

mkdir -p ~/.agents/agents ./instructions
curl -fsSL "$ASSETS_BASE_URL/agents/<agent-file>.agent.md" -o ~/.agents/agents/<agent-file>.agent.md
curl -fsSL "$ASSETS_BASE_URL/instructions/<name>.instructions.md" -o ./instructions/<name>.instructions.md

Notes:

• The base URL is only defined once.
• Cloning the repo is still recommended if you want updates and version history.

Install Agents (Clone And Copy)

Agents are prompt files that live under assets/agents.

git clone git@<host>:org/ai-assets.git
mkdir -p ~/.agents/agents
cp -R ai-assets/agents/* ~/.agents/agents/

Install Instructions (Clone And Copy)

Instructions are repo-level rule files. Copy them into your project.

git clone git@<host>:org/ai-assets.git
mkdir -p ./instructions
cp -R ai-assets/instructions/* ./instructions/