INSTALL.md

安装说明

方式一：Git clone 后复制（推荐）

git clone git@github.com:wangbooth/skills.git
mkdir -p ~/.prime/agent/skills
cp -r skills/vision skills/websearch skills/degradation-diagnosis ~/.prime/agent/skills/

按项目安装（想提交到项目仓库）：复制到 <项目>/.prime/agent/skills/ 即可。

方式二：settings 直接引用仓库路径（不复制）

{ "skills": ["~/skills"] }

要求克隆位置固定（如 ~/skills），skill 目录在仓库根目录。

方式三：tar 包

tar -xzf prime-agent-skills.tar.gz   # 解出 vision/ websearch/ degradation-diagnosis/ INSTALL.md README.md
cp -r vision websearch degradation-diagnosis ~/.prime/agent/skills/

安装后

1. 在 agent 里执行 /reload 重新发现 skill。
2. 新开一个会话 —— Python-backed skill 在会话启动时装进 kernel venv，新会话才能 import vision / import websearch。degradation-diagnosis 本身是指令型 Skill，不依赖 kernel 安装。

（可选）禁用内置 Serper 版 websearch

编辑 ~/.prime/agent/settings.json：

{ "bundledSkills": { "websearch": false } }

说明：即使不禁止，自定义同名 websearch 优先级更高会自动覆盖内置版；此项只是彻底关掉。

前置要求（无法随仓库传递）

• vision / websearch 需要 opencode-go 凭据：~/.prime/agent/auth.json 里 opencode-go.key（或 ~/.pi/agent/auth.json）
• vision / websearch 调用 https://opencode.ai/zen/go/v1，模型固定 gpt-5.6-luna
• degradation-diagnosis 不需要外部 API；附带脚本仅使用 Python 3.10+ 标准库

注意事项

• 不要提交/分享 auth.json 或任何 API key（本仓库只含代码，不含密钥）。
• vision 磁盘缓存 ~/.prime/agent/cache/vision-cache/ 不在仓库内，接收者首次使用会重建。
• 目录名必须与 SKILL.md 的 name 一致，src/<import_name>/__init__.py 布局不能改。