5分钟快速上手pi-skills：给Claude Code和Codex CLI安装AI技能的完整教程
【免费下载链接】pi-skillsSkills for pi coding agent (compatible with Claude Code and Codex CLI)项目地址: https://gitcode.com/gh_mirrors/pi/pi-skills
pi-skills 是一个开源技能包仓库，一条git clone命令即可为Claude Code、Codex CLI等 AI 编程助手安装 8 个开箱即用的 AI 技能：网页搜索、浏览器自动化、谷歌日历/网盘/邮箱、语音转文字、YouTube 字幕提取和 VS Code 差异对比。本文带你完成 pi-skills 安装教程，从零到可用只需 5 分钟。⏱️
什么是 pi-skills？AI 技能包解决什么问题
AI 编程助手本身只会写代码，但 pi-skills 给它"装上了手和眼"：
- 🌐联网搜索：让助手查文档、查资料，不用你手动复制粘贴
- 🖥️浏览器自动化：通过 Chrome DevTools Protocol 真实操作网页
- 📧谷歌全家桶：日历、Drive、Gmail 全部命令行化
- 🎬内容提取：音频转文字、YouTube 视频字幕一键抓取
- 🔍代码对比：直接在 VS Code 中并排查看文件差异
每个技能都以SKILL.md文件为入口，遵循 Claude Code 技能格式，助手会按需自动调用。
最快安装方法：三种客户端一键接入
💡 前提：已安装 Git。仓库地址为
https://gitcode.com/gh_mirrors/pi/pi-skills
方式一：Codex CLI（最简单）
直接克隆到技能目录，全部技能立即可用：
git clone https://gitcode.com/gh_mirrors/pi/pi-skills ~/.codex/skills/pi-skills方式二：pi-coding-agent
# 用户级（所有项目可用） 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-skills方式三：Claude Code（需要软链接）
Claude Code 只向下查找一层SKILL.md，因此需要把每个技能目录软链接到技能目录：
# 1. 克隆到方便的位置 git clone https://gitcode.com/gh_mirrors/pi/pi-skills ~/pi-skills # 2. 创建技能目录 mkdir -p ~/.claude/skills # 3. 逐个软链接技能（按需选择） ln -s ~/pi-skills/brave-search ~/.claude/skills/brave-search ln -s ~/pi-skills/browser-tools ~/.claude/skills/browser-tools ln -s ~/pi-skills/transcribe ~/.claude/skills/transcribe # 其余技能同理：gccli、gdcli、gmcli、vscode、youtube-transcript项目级配置则把目标换成.claude/skills即可。完成后重启客户端，让助手说一句"搜索一下最近的 Node.js 版本"，技能就会被自动触发。
8 个内置技能清单：按需启用
| 技能 | 功能 | 文档 |
|---|---|---|
| brave-search | 网页搜索 + 网页正文提取，无需浏览器 | SKILL.md |
| browser-tools | 交互式浏览器自动化（导航、截图、元素选取、Cookie 调试） | SKILL.md |
| gccli | 谷歌日历：查事件、建日程、看空闲时间 | SKILL.md |
| gdcli | 谷歌网盘：上传下载、全文搜索、共享文件 | SKILL.md |
| gmcli | Gmail：搜索邮件、读会话、发消息、管草稿 | SKILL.md |
| transcribe | 语音转文字，支持 mp3/m4a/wav 等格式 | SKILL.md |
| vscode | 在 VS Code 中并排对比文件与 Git 差异 | SKILL.md |
| youtube-transcript | 抓取 YouTube 视频字幕，带时间戳 | SKILL.md |
每个技能的源码与说明都清晰可见，例如 search.js 实现搜索、transcribe.sh 实现语音转写，方便二次修改。
技能依赖速查表：提前准备好这些配置
大部分技能"开箱即用"，但部分需要一次性配置。助手通常能引导你完成，这里给出速查表：
| 技能 | 依赖 |
|---|---|
| brave-search | Node.js，技能目录内执行npm install，另需 Brave 免费 API Key（环境变量BRAVE_API_KEY） |
| browser-tools | Chrome + Node.js，技能目录内执行npm install |
| gccli / gdcli / gmcli | Node.js，全局安装对应 npm 包，需在 Google Cloud 创建 OAuth 凭据 |
| transcribe | curl + Groq API Key（环境变量GROQ_API_KEY） |
| vscode | 已安装 VS Code 且code命令在 PATH 中 |
| youtube-transcript | Node.js，技能目录内执行npm install |
以语音转写为例，只需两步：在 shell 配置文件里export GROQ_API_KEY="你的key"，然后运行 transcribe.sh 传入音频文件即可。
技能文件格式揭秘：SKILL.md 是如何工作的
每个技能本质是一份"说明书 + 工具脚本"的组合。以 transcribe/SKILL.md 为例，结构如下：
- YAML 头：
name和description，助手靠 description 判断"什么时候该用这个技能" - 正文指令：详细的使用步骤、参数说明和适用场景
{baseDir}占位符：运行时自动替换为技能所在目录的绝对路径
这种 pi/Claude Code 通用格式意味着：一份技能文件，pi-coding-agent、Claude Code、Codex CLI、Amp、Droid 都能直接使用——这正是 pi-skills 最大的价值。🎯
总结：5 分钟给 AI 助手"开挂"
回顾一下 pi-skills 快速上手的核心步骤：
- 确认客户端类型，选择对应安装方式
- 执行
git clone+ 软链接（Claude Code）或单条克隆命令（Codex CLI） - 按依赖表补齐 API Key 和 npm 包
- 重启客户端，直接用自然语言下达任务
8 个技能覆盖"搜索—浏览—办公—多媒体—代码审查"全链路，MIT 协议开源，可以放心使用。装完之后，你的 AI 编程助手不再只是代码工具，而是一个能查资料、开浏览器、管日历、转语音的完整数字助手。
【免费下载链接】pi-skillsSkills for pi coding agent (compatible with Claude Code and Codex CLI)项目地址: https://gitcode.com/gh_mirrors/pi/pi-skills
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
