86 lines
2.7 KiB
Markdown
86 lines
2.7 KiB
Markdown
# 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
|
|
```bash
|
|
SKILLS_FILE=./assets/ios-skills.yaml ./assets/sync-skills.sh
|
|
```
|
|
|
|
### Android
|
|
```bash
|
|
SKILLS_FILE=./assets/android-skills.yaml ./assets/sync-skills.sh
|
|
```
|
|
|
|
### Shared (All Platforms)
|
|
```bash
|
|
SKILLS_FILE=./assets/shared-skills.yaml ./assets/sync-skills.sh
|
|
```
|
|
|
|
### iOS + Shared
|
|
```bash
|
|
SKILLS_FILE=./assets/shared-skills.yaml ./assets/sync-skills.sh
|
|
SKILLS_FILE=./assets/ios-skills.yaml ./assets/sync-skills.sh
|
|
```
|
|
|
|
### Android + Shared
|
|
```bash
|
|
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.
|
|
|
|
```bash
|
|
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.
|
|
|
|
```bash
|
|
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.
|
|
|
|
```bash
|
|
git clone git@<host>:org/ai-assets.git
|
|
mkdir -p ./instructions
|
|
cp -R ai-assets/instructions/* ./instructions/
|
|
``` |