mbrucedogs/ai-docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: move skills sync into assets

Browse Source
This commit is contained in:
Matt Bruce 2026-02-11 11:37:29 -06:00
parent 70bb8c1422
commit 648ee9a8c9
5 changed files with 20 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
Agents.md
View File

@ -75,8 +75,8 @@ If you update any file in this repo, commit and push right away so other develop
## Skills Sync ## Skills Sync
This repo uses a skills manifest to standardize skills across developers. This repo uses a skills manifest to standardize skills across developers.
1. Review skills.yaml for the approved install list. 1. Review the curated list under assets/.
2. Run ./scripts/sync-skills.sh (uses the `npx skills` CLI). 2. Run ./assets/sync-skills.sh (uses the `npx skills` CLI).
3. Restart your editor if needed. 3. Restart your editor if needed.
## Suggested Agent Request Template ## Suggested Agent Request Template

1
assets/README.md
View File

@ -6,5 +6,6 @@ Contents:
- agents/: Agent prompt files - agents/: Agent prompt files
- instructions/: Repo-level instruction files - instructions/: Repo-level instruction files
- ios-skills.yaml, android-skills.yaml, shared-skills.yaml: Curated skills lists - 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. Do not add handbook content here. Use docs/ai for the guide.

5
scripts/sync-skills.sh → assets/sync-skills.sh
View File

@ -2,7 +2,8 @@
set -euo pipefail set -euo pipefail
ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)" ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
MANIFEST="$ROOT_DIR/skills.yaml" MANIFEST_DEFAULT="$ROOT_DIR/assets/shared-skills.yaml"
MANIFEST="${SKILLS_FILE:-$MANIFEST_DEFAULT}"
if [[ ! -f "$MANIFEST" ]]; then if [[ ! -f "$MANIFEST" ]]; then
echo "Missing skills manifest: $MANIFEST" >&2 echo "Missing skills manifest: $MANIFEST" >&2
@ -12,7 +13,7 @@ fi
INSTALLS=$(sed -n 's/^[[:space:]]*install:[[:space:]]*//p' "$MANIFEST" | sed 's/^"//;s/"$//') INSTALLS=$(sed -n 's/^[[:space:]]*install:[[:space:]]*//p' "$MANIFEST" | sed 's/^"//;s/"$//')
if [[ -z "$INSTALLS" ]]; then if [[ -z "$INSTALLS" ]]; then
echo "No install entries found in skills.yaml" >&2 echo "No install entries found in: $MANIFEST" >&2
exit 1 exit 1
fi fi

20
docs/ai/skills.md
View File

@ -67,17 +67,25 @@ skills:
``` ```
### Sync Workflow ### Sync Workflow
1. Run the sync script. 1. Update the curated list in assets (shared, iOS, or Android).
2. The script installs each skill using the `npx skills` CLI. 2. Run the sync script.
3. The script installs each skill using the `npx skills` CLI.
3. Restart your editor if required. 3. Restart your editor if required.
### Example Sync Command ### Example Sync Command
```bash ```bash
./scripts/sync-skills.sh ./assets/sync-skills.sh
```
### Platform-Specific Install
Set `SKILLS_FILE` to install a platform list:
```bash
SKILLS_FILE=./assets/ios-skills.yaml ./assets/sync-skills.sh
``` ```
## Skills CLI (Single Path) ## Skills CLI (Single Path)
We use a single, approved path: update skills.yaml and run the sync script. The sync script calls `npx skills add` for each entry. We use a single, approved path: update the curated list under assets/ and run the sync script. The sync script calls `npx skills add` for each entry.
### Where To Find Skills ### Where To Find Skills
- Homepage: https://skills.sh/ - Homepage: https://skills.sh/
@ -85,8 +93,8 @@ We use a single, approved path: update skills.yaml and run the sync script. The
- CLI reference: https://skills.sh/docs/cli - CLI reference: https://skills.sh/docs/cli
### How It Works (High-Level) ### How It Works (High-Level)
1. You update skills.yaml with the approved install entries. 1. You update assets/shared-skills.yaml (or a platform list) with approved install entries.
2. Run ./scripts/sync-skills.sh. 2. Run ./assets/sync-skills.sh.
3. The script uses `npx skills` to install each skill. 3. The script uses `npx skills` to install each skill.
### Install The CLI (No Global Install Required) ### Install The CLI (No Global Install Required)

8
skills.yaml
View File

@ -1,8 +0,0 @@
version: 1
skills:
- name: swiftui-expert-skill
install: "https://github.com/avdlee/swiftui-agent-skill --skill swiftui-expert-skill"
- name: onboarding-cro
install: "vercel-labs/agent-skills"
- name: webapp-testing
install: "vercel-labs/agent-skills"