pi-skills安装全攻略适配Claude Code、Codex CLI、Amp与Droid的软链接技巧详解【免费下载链接】pi-skillsSkills for pi coding agent (compatible with Claude Code and Codex CLI)项目地址: https://gitcode.com/gh_mirrors/pi/pi-skillspi-skills 是专为 pi coding agent 打造的一站式技能扩展集合兼容Claude Code、Codex CLI、Amp、Droid四大主流 AI 编程智能体内置网页搜索、浏览器自动化、Google 全家桶 CLI、语音转写等 8 个开箱即用的实用技能。本指南将带你完整掌握 pi-skills 的安装方法与软链接配置技巧5 分钟即可完成全部部署。为什么值得安装8个实用技能一览 pi-skills 的每个技能都以独立文件夹组织内含一个 SKILL.md 说明文件和配套脚本安装后即可被智能体自动发现技能功能文档brave-search无需浏览器的网页搜索与内容提取brave-search/SKILL.mdbrowser-tools基于 Chrome DevTools 协议的交互式浏览器自动化browser-tools/SKILL.mdgccliGoogle Calendar 日历与日程查询gccli/SKILL.mdgdcliGoogle Drive 文件管理与共享gdcli/SKILL.mdgmcliGmail 邮件、草稿与标签管理gmcli/SKILL.mdtranscribe基于 Groq Whisper 的语音转文字transcribe/SKILL.mdvscodeVS Code 差异对比与文件比较vscode/SKILL.mdyoutube-transcript获取 YouTube 视频字幕youtube-transcript/SKILL.md 完整技能列表与安装说明见 README.md许可证为 MIT。快速开始克隆 pi-skills 仓库无论使用哪个客户端第一步都是把仓库克隆到本地。不同客户端只需要调整目标目录下面按客户端逐一讲解 git clone https://gitcode.com/gh_mirrors/pi/pi-skillsCodex CLI 安装用户级目录直接克隆Codex CLI 支持递归发现技能直接克隆到用户级技能目录即可所有项目共享git clone https://gitcode.com/gh_mirrors/pi/pi-skills ~/.codex/skills/pi-skills✅ 最简单的一种安装方式无需任何额外配置。Amp 安装工具箱递归发现技能Amp 会在工具箱toolbox目录中递归查找技能因此克隆到用户级工具箱目录即可git clone https://gitcode.com/gh_mirrors/pi/pi-skills ~/.config/amp/tools/pi-skillsDroidFactory安装用户级或项目级二选一Droid 同时支持两种作用域按需选择# 用户级全局可用 git clone https://gitcode.com/gh_mirrors/pi/pi-skills ~/.factory/skills/pi-skills # 项目级仅当前项目可用 git clone https://gitcode.com/gh_mirrors/pi/pi-skills .factory/skills/pi-skillspi-coding-agent 安装原生支持作为 pi-skills 的原生宿主同样支持用户级与项目级两种安装位置# 用户级 git clone https://gitcode.com/gh_mirrors/pi/pi-skills ~/.pi/agent/skills/pi-skills # 项目级 git clone https://gitcode.com/gh_mirrors/pi/pi-skills .pi/skills/pi-skillsClaude Code 安装软链接技巧详解 这是整个安装流程中最关键的一步。与其他客户端不同Claude Code 只会向技能目录向下查找一层SKILL.md文件——这意味着每个技能文件夹必须直接位于skills 目录下而不能嵌套在仓库目录里。正确的做法分两步先把仓库克隆到任意位置再用软链接symlink把每个技能挂进技能目录。第一步克隆仓库到便捷位置git clone https://gitcode.com/gh_mirrors/pi/pi-skills ~/pi-skills第二步为每个技能创建软链接用户级mkdir -p ~/.claude/skills ln -s ~/pi-skills/brave-search ~/.claude/skills/brave-search ln -s ~/pi-skills/browser-tools ~/.claude/skills/browser-tools ln -s ~/pi-skills/gccli ~/.claude/skills/gccli ln -s ~/pi-skills/gdcli ~/.claude/skills/gdcli ln -s ~/pi-skills/gmcli ~/.claude/skills/gmcli ln -s ~/pi-skills/transcribe ~/.claude/skills/transcribe ln -s ~/pi-skills/vscode ~/.claude/skills/vscode ln -s ~/pi-skills/youtube-transcript ~/.claude/skills/youtube-transcript项目级软链接把目标改为 .claude/skills如果只想让技能在单个项目中生效把目标目录换成项目内的.claude/skills即可mkdir -p .claude/skills ln -s ~/pi-skills/brave-search .claude/skills/brave-search # 其余技能同理按需创建软链接的核心优势一处更新处处生效在~/pi-skills里执行git pull拉取新版技能所有软链接自动指向最新内容✂️按需裁剪只链接自己需要的技能避免加载无关内容️目录结构清晰技能目录平铺一层符合 Claude Code 的单层查找规则安装后必做技能依赖配置清单软链接只是让技能可见部分技能还需要额外依赖才能真正跑起来。对照下面的清单检查一遍 ✅技能依赖要求安装命令brave-searchNode.js技能目录内执行npm install并配置BRAVE_API_KEYbrowser-toolsChrome Node.js技能目录内执行npm installgccli / gdcli / gmcliNode.jsnpm install -g mariozechner/gccligdcli、gmcli 同理transcribecurl Groq API Key设置环境变量GROQ_API_KEYvscodeVS Code 且codeCLI 在 PATH 中安装 VS Code 并启用 CLIyoutube-transcriptNode.js技能目录内执行npm install提示通常智能体遇到缺失依赖会主动引导你完成配置无需全部手动设置。理解技能格式{baseDir} 占位符的作用每个技能都遵循统一的 pi / Claude Code 格式YAML 头部声明name和description智能体据此判断何时调用技能正文是详细指令。其中的{baseDir}占位符会在运行时被替换为该技能的实际目录路径因此配套脚本如 transcribe/transcribe.sh、brave-search/search.js无需硬编码路径即可被正确调用。这种设计正是软链接方案能够无缝工作的前提——无论技能被链接到哪里{baseDir}都会解析到真实位置。常见问题排查 ️Q1软链接后技能没有出现在 Claude Code 里依次检查三点软链接是否指向了技能文件夹本身而非其父目录链接目标路径是否正确ls -l ~/.claude/skills查看是否有红色失效链接重启 Claude Code 会话让它重新扫描技能目录Q2用户级和项目级应该选哪个日常通用技能搜索、转写建议放用户级仅服务于特定仓库的技能如项目专属的浏览器自动化脚本放项目级便于随仓库提交共享给团队成员。Q3如何更新技能到最新版本只需在克隆的仓库根目录执行git pull所有软链接指向的内容即刻同步无需重建链接。总结pi-skills 用统一的技能格式覆盖了四大 AI 编程客户端Codex CLI、Amp、Droid 与 pi-coding-agent 只需一条git clone命令即可完成安装Claude Code 则依赖克隆 软链接两步走既满足单层查找规则又保留了集中更新的便利。按照本文清单配好依赖后你的智能体就已经具备了网页搜索、浏览器操作、Google 套件与语音转写等完整能力 【免费下载链接】pi-skillsSkills for pi coding agent (compatible with Claude Code and Codex CLI)项目地址: https://gitcode.com/gh_mirrors/pi/pi-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考