Pi Skills Library

本仓库整理当前 Pi 环境中的本地自有 Skill，并记录第三方 Skill 和扩展的安装来源。

Inventory

当前用户级目录 ~/.pi/agent/skills 共发现 16 个 Skill。

Included Skills

以下 3 个 Skill 作为本地自有/定制内容收录在 skills/：

| Skill | 用途 | 运行要求 | |---|---|---| | lookfor-banana | 通过 lookfor.cc 的 Gemini generateContent 图像协议 | Node.js 18+，LOOKFOR_DAXIANGJIAO_API_KEY | | lookfor-image-2 | 通过 lookfor.cc 的 OpenAI-compatible Images API 调用 image-2 / gpt-image-2 | Node.js 18+，LOOKFOR_IMAGE2_API_KEY | | tavily-search | 指导 Pi 使用已注册的 tavily_search 工具 | Pi 中需已有 tavily_search 工具 |

Third-Party Skills

以下 13 个 Skill 未复制进仓库，避免重新分发第三方或专有内容。

| Skill | 来源判断 | 安装或获取方式 | |---|---|---| | hyperframes | HeyGen HyperFrames | npx skills add heygen-com/hyperframes | | hyperframes-animation | HeyGen HyperFrames 套件 | npx skills add heygen-com/hyperframes | | hyperframes-cli | HeyGen HyperFrames 套件 | npx skills add heygen-com/hyperframes | | hyperframes-core | HeyGen HyperFrames 套件 | npx skills add heygen-com/hyperframes | | hyperframes-creative | HeyGen HyperFrames 套件 | npx skills add heygen-com/hyperframes | | hyperframes-keyframes | HeyGen HyperFrames 套件 | npx skills add heygen-com/hyperframes | | hyperframes-registry | HeyGen HyperFrames 套件 | npx skills add heygen-com/hyperframes | | faceless-explainer | HeyGen HyperFrames 工作流 | npx skills add heygen-com/hyperframes | | docx | Anthropic 专有 Skill | 从原授权产品或官方分发渠道获取，不得从本仓库再分发 | | pdf | Anthropic 专有 Skill | 从原授权产品或官方分发渠道获取，不得从本仓库再分发 | | pptx | Anthropic 专有 Skill | 从原授权产品或官方分发渠道获取，不得从本仓库再分发 | | xlsx | Anthropic 专有 Skill | 从原授权产品或官方分发渠道获取，不得从本仓库再分发 | | edge-tts | 来源未确认的第三方 Skill 模板 | 暂不提供 Skill 安装命令；底层工具可用 uvx edge-tts --help 验证 |

edge-tts 的 Skill 文本没有作者、许可证或上游地址。确认来源和许可前，不应复制到公开仓库。

Third-Party Pi Extensions

本机还安装了以下 npm 扩展。它们不是本仓库的 Skill 源码：

pi install npm:@sartoris/pi-superpowers
pi install npm:@tintinweb/pi-subagents
pi install npm:@hhyy668/pi-desktop-ui
pi install npm:@hhyy668/claude-workflow-for-pi

盘点时安装的版本范围：

| Package | Version | |---|---| | @sartoris/pi-superpowers | ^2.2.0 | | @tintinweb/pi-subagents | ^0.14.1 | | @hhyy668/pi-desktop-ui | ^1.3.3 | | @hhyy668/claude-workflow-for-pi | ^0.1.1 |

Install Included Skills

Pi Package (recommended)

pi install npm:@hhyy668/pi-skills-library

Pi reads the package's pi.skills manifest and loads the included skills/ directory. Restart Pi or run /reload after installation. This npm package does not run a postinstall script and does not automatically configure or persist API keys.

Windows

git clone <repository-url> pi-skills-library
cd pi-skills-library
powershell -ExecutionPolicy Bypass -File .\install.ps1

# 已存在同名 Skill 时，先备份再替换
powershell -ExecutionPolicy Bypass -File .\install.ps1 -Force

# 可选：安装后交互式配置 Windows 用户环境变量
powershell -ExecutionPolicy Bypass -File .\install.ps1 -ConfigureKeys

安装脚本会：

1. 将 skills/ 中的 Skill 安装到 $PI_CODING_AGENT_DIR\skills，未设置时使用 $HOME\.pi\agent\skills。
2. 默认拒绝覆盖已有同名 Skill；-Force 会先备份旧目录，再完整替换。
3. 使用带持久事务记录的安装锁避免并发写入；若安装进程异常退出，下次运行会先恢复未提交事务。来源、目标或路径祖先包含符号链接/reparse point 时会拒绝安装。
4. 检查两个 lookfor.cc API Key 环境变量，并对缺失的 Key 显示注册网址。
5. 只有显式传入 -ConfigureKeys 才会交互式写入 Windows 用户环境变量；该存储方式不是加密的秘密存储。配置后需从新的终端会话启动 Pi。
6. 不会把 API Key 写入仓库或 Skill 文件。

Linux/macOS

git clone <repository-url> pi-skills-library
cd pi-skills-library
bash ./install.sh

# 已存在同名 Skill 时，先备份再替换
bash ./install.sh --force

脚本优先安装到 $PI_CODING_AGENT_DIR/skills，未设置时使用 ~/.pi/agent/skills。默认拒绝覆盖已有 Skill；--force 会先备份再完整替换。安装锁会拒绝并发安装，并记录可在下次运行时恢复的事务状态；来源、目标或路径祖先包含符号链接时也会拒绝安装。为避免擅自修改 shell 配置，Key 由用户自行写入 ~/.bashrc、~/.zshrc 或系统密钥管理工具。

仅安装或更新 Skill 后，可在 Pi 中执行：

/reload

新增或修改 API Key 后，/reload 不会刷新进程环境；请从新的终端会话重新启动 Pi。

API Keys

图片 Skill 使用 lookfor.cc。请先在以下网站注册并获取 API Key：

• https://lookfor.cc/

需要的环境变量：

| Skill | Required variable | |---|---| | lookfor-banana | LOOKFOR_DAXIANGJIAO_API_KEY | | lookfor-image-2 | LOOKFOR_IMAGE2_API_KEY |

Windows 手动配置：

[Environment]::SetEnvironmentVariable("LOOKFOR_DAXIANGJIAO_API_KEY", "your-key", "User")
[Environment]::SetEnvironmentVariable("LOOKFOR_IMAGE2_API_KEY", "your-key", "User")

Linux/macOS 当前会话配置：

export LOOKFOR_DAXIANGJIAO_API_KEY="your-key"
export LOOKFOR_IMAGE2_API_KEY="your-key"

不要在 Issue、聊天、Git 提交或命令行参数中公开 API Key。

Image API Notes

lookfor-banana 使用 POST https://lookfor.cc/v1/models/{model}:generateContent，请求是 Gemini 原生的 contents 与 generationConfig，返回图片位于 candidates[].content.parts[].inlineData。当前只发送 responseModalities: ["IMAGE"]、imageConfig.aspectRatio（1:1、2:3、3:2）和 imageSize: "1K"；不发送 Gemini 没有可靠请求字段的输出 MIME、质量或透明背景选项。脚本按响应 MIME 和真实文件签名保存扩展名，显式扩展不匹配会报错。

lookfor-image-2 保持 /v1/images/generations 的兼容协议，gpt-image-2 默认 quality 为 low，共享请求/下载 deadline 为 240 秒，并且不发送 response_format。官方 GPT Image 响应始终使用 b64_json；HTTP 504 表示上游生成超时。gpt-image-2 的 transparent background 在请求前拒绝，不能用于透明输出。

协议参考：Gemini image generation、Gemini generateContent、OpenAI image generation、GPT Image 2。

Repository Safety

提交前运行：

git diff --cached
git grep -ni -I -E '(api[_-]?key|authorization|bearer|secret|token|sk-[a-z0-9_-]{16,})'
# 公开仓库建议在 CI 中再运行 Gitleaks 或 TruffleHog

环境变量名称和安装说明会命中搜索，这是正常的；任何真实密钥都必须删除并立即轮换。

License

本仓库只应发布你有权分发的本地 Skill。添加公开许可证前，请确认这 3 个收录内容的作者和权属。第三方项目保留各自版权和许可，本仓库不授予其再分发权。