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. If your host needs a token, put it in one place.

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

curl -fsSL -H "Authorization: Bearer $ASSETS_TOKEN" \
	"$ASSETS_BASE_URL/sync-skills.sh" -o /tmp/sync-skills.sh
curl -fsSL -H "Authorization: Bearer $ASSETS_TOKEN" \
	"$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 -H "Authorization: Bearer $ASSETS_TOKEN" \
	"$ASSETS_BASE_URL/agents/<agent-file>.agent.md" -o ~/.agents/agents/<agent-file>.agent.md
curl -fsSL -H "Authorization: Bearer $ASSETS_TOKEN" \
	"$ASSETS_BASE_URL/instructions/<name>.instructions.md" -o ./instructions/<name>.instructions.md

Notes:

The token and base URL are only defined once.
Remove the Authorization header if your host does not require it.
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/

2.7 KiB Raw Blame History