pi-skills

适用于 pi-coding-agent 的技能集合，兼容 Claude Code、Codex CLI、Amp 和 Droid。

安装

pi-coding-agent

# 用户级（在所有项目中可用）
git clone https://github.com/badlogic/pi-skills ~/.pi/agent/skills/pi-skills

# 或项目级
git clone https://github.com/badlogic/pi-skills .pi/skills/pi-skills

Codex CLI

git clone https://github.com/badlogic/pi-skills ~/.codex/skills/pi-skills

Amp

Amp 会递归地在工具箱中查找技能：

git clone https://github.com/badlogic/pi-skills ~/.config/amp/tools/pi-skills

Droid (Factory)

# 用户级
git clone https://github.com/badlogic/pi-skills ~/.factory/skills/pi-skills

# 或项目级
git clone https://github.com/badlogic/pi-skills .factory/skills/pi-skills

Claude Code

Claude Code 只会在第一层目录中查找 SKILL.md 文件，因此每个技能文件夹必须直接位于技能目录下。先将仓库克隆到某个位置，然后为每个技能创建符号链接：

# 克隆到方便的位置
git clone https://github.com/badlogic/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

# 或项目级
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

可用技能

技能	描述
brave-search	通过 Brave Search 进行网页搜索和内容提取
browser-tools	通过 Chrome DevTools Protocol 实现交互式浏览器自动化
gccli	Google Calendar 命令行工具，用于管理日程和查看空闲时间
gdcli	Google Drive 命令行工具，用于文件管理和共享
gmcli	Gmail 命令行工具，用于发送邮件、管理草稿和标签
transcribe	通过 Groq Whisper API 进行语音转文字转录
vscode	VS Code 集成，用于比较差异和文件对比
youtube-transcript	获取 YouTube 视频字幕

技能格式

每个技能都遵循 pi/Claude Code 格式：

---
name: 技能名
description: 显示给代理的简短描述
---

# 指令

详细的使用说明在此...
辅助文件位于：{baseDir}/

运行时，{baseDir} 占位符会被替换为该技能的目录路径。

依赖要求

部分技能需要额外的设置。通常情况下，代理会引导你完成这些步骤。如果没有，请参考以下说明：

• brave-search：需要 Node.js。在技能目录中运行 npm install。
• browser-tools：需要 Chrome 和 Node.js。在技能目录中运行 npm install。
• gccli：需要 Node.js。使用 npm install -g @mariozechner/gccli 进行全局安装。
• gdcli：需要 Node.js。使用 npm install -g @mariozechner/gdcli 进行全局安装。
• gmcli：需要 Node.js。使用 npm install -g @mariozechner/gmcli 进行全局安装。
• subagent：需要 pi-coding-agent。使用 npm install -g @mariozechner/pi-coding-agent 进行全局安装。
• transcribe：需要 curl 和一个 Groq API 密钥。
• vscode：需要 VS Code，并且 code 命令行工具需在 PATH 中。
• youtube-transcript：需要 Node.js。在技能目录中运行 npm install。

许可证

MIT

pi-skills 快速上手指南

pi-skills 是一套专为 AI 编程助手（如 pi-coding-agent、Claude Code、Codex CLI、Amp 和 Droid）设计的技能集合，提供网页搜索、浏览器自动化、Google 全家桶操作、语音转录及 VS Code 集成等功能。

环境准备

在开始之前，请确保您的系统满足以下基础要求：

• 操作系统：Linux / macOS / Windows (WSL)
• 核心依赖：
  • git：用于克隆仓库。
  • Node.js & npm：大部分技能需要 Node.js 环境。
  • 特定工具：
    • brave-search / browser-tools / youtube-transcript：需在技能目录运行 npm install。
    • gccli / gdcli / gmcli：需全局安装对应 npm 包（见下文安装步骤）。
    • transcribe：需要 curl 和 Groq API Key。
    • vscode：需安装 VS Code 并将 code 命令加入环境变量 PATH。
    • browser-tools：需安装 Google Chrome 浏览器。

提示：国内开发者若遇到 npm 安装缓慢，可临时切换镜像源： npm config set registry https://registry.npmmirror.com

安装步骤

根据您的 AI 代理工具选择对应的安装方式。

1. pi-coding-agent

用户级安装（所有项目可用）：

git clone https://github.com/badlogic/pi-skills ~/.pi/agent/skills/pi-skills

项目级安装：

git clone https://github.com/badlogic/pi-skills .pi/skills/pi-skills

2. Codex CLI

git clone https://github.com/badlogic/pi-skills ~/.codex/skills/pi-skills

3. Amp

Amp 会在工具箱中递归查找技能：

git clone https://github.com/badlogic/pi-skills ~/.config/amp/tools/pi-skills

4. Droid (Factory)

用户级安装：

git clone https://github.com/badlogic/pi-skills ~/.factory/skills/pi-skills

项目级安装：

git clone https://github.com/badlogic/pi-skills .factory/skills/pi-skills

5. Claude Code

由于 Claude Code 仅扫描技能目录下的一层文件，需先克隆仓库，再为每个技能创建软链接。

第一步：克隆仓库到任意位置

git clone https://github.com/badlogic/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 即可)

6. 额外依赖安装

部分技能需要单独安装依赖，请在终端执行以下命令：

# 针对 brave-search, browser-tools, youtube-transcript (进入对应技能目录后执行)
cd ~/pi-skills/brave-search && npm install
cd ~/pi-skills/browser-tools && npm install
cd ~/pi-skills/youtube-transcript && npm install

# 针对 Google 系列 CLI 工具 (全局安装)
npm install -g @mariozechner/gccli
npm install -g @mariozechner/gdcli
npm install -g @mariozechner/gmcli

基本使用

安装完成后，无需额外配置代码，直接在支持的 AI 代理对话中调用相应功能即可。AI 会自动识别并加载这些技能。

使用示例：

• 网页搜索：

  "请使用 brave-search 帮我查找最新的 Rust 异步编程教程。"

• 浏览器操作：

  "使用 browser-tools 打开 example.com 并截取首页截图。"

• 日历管理：

  "用 gccli 查看我明天上午的会议安排。"

• 文件管理：

  "通过 gdcli 列出我 Google Drive 根目录下的所有 PDF 文件。"

• 邮件处理：

  "使用 gmcli 起草一封发给团队的周报邮件。"

• 语音转录：

  "调用 transcribe 技能将这个音频文件转换为文字。"

• 代码对比：

  "使用 vscode 技能比较当前目录下两个文件的差异。"

• 视频内容获取：

  "利用 youtube-transcript 获取该 YouTube 视频的字幕文本。"

注意：首次使用涉及第三方服务（如 Google API、Groq API）的技能时，AI 代理通常会引导您完成密钥配置或授权流程。