From 3bffaaab852eeffb1fd94c1ef184ebdb273ecb0c Mon Sep 17 00:00:00 2001
From: Matt Bruce <matt.bruce1@toyota.com>
Date: Wed, 11 Feb 2026 11:07:06 -0600
Subject: [PATCH] docs: add skills.sh usage

---
 docs/ai/skills.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/docs/ai/skills.md b/docs/ai/skills.md
index b2677fb..180ef00 100644
--- a/docs/ai/skills.md
+++ b/docs/ai/skills.md
@@ -63,6 +63,23 @@ skills:
 ./scripts/sync-skills.sh
 ```
 
+## skills.sh (Optional Skills Installer)
+skills.sh provides a public skills catalog and a CLI to install skills by name. Use this only if your team allows it and you understand the source of the skills you install.
+
+### How It Works (High-Level)
+1. You run the `skills` CLI via `npx`.
+2. The CLI downloads the skill and configures it for your agent environment.
+3. The skill becomes available to your AI agent.
+
+### Example Install Command
+```bash
+npx skills add vercel-labs/agent-skills
+```
+
+### Notes
+- The leaderboard uses anonymous telemetry from the CLI. You can opt out by setting `DISABLE_TELEMETRY=1`.
+- Review skills before installing. The ecosystem is audited, but quality varies.
+
 ## How to Download Existing Skills
 1. Locate the skill in the team or org repository.
 2. Add the skill to your local skills directory following team guidance.