Pi Skills 遵循 Agent Skills 标准，是以 Markdown 文件形式存储的按需能力包。
基本结构
<!-- ~/.pi/agent/skills/my-skill/SKILL.md -->
# My Skill
Use this skill when the user asks about X.
## Steps
1. Do this
2. Then that调用方式
- 显式调用：
/skill:name - 自动调用：Agent 根据上下文判断自动加载
加载位置
Pi 从以下位置扫描 Skills（从当前目录向上遍历）：
~/.pi/agent/skills/— 全局用户 skills~/.agents/skills/— 全局 agent skills 标准位置.pi/skills/— 项目级 skills.agents/skills/— 项目级 agent skills 标准位置
与 Claude Code Skills 的对比
Pi Skills 和 Claude Code Skills 均遵循相同的 Agent Skills 标准（agentskills.io），因此同一套 Skill 文件可以在两个工具之间复用：
| 维度 | Pi | Claude Code |
|---|---|---|
| 标准 | agentskills.io | agentskills.io |
| 调用 | /skill:name 或 Agent 自动 | /skill-name 或 Agent 自动 |
| 文件位置 | ~/.pi/agent/skills/ 等 | ~/.claude/skills/ 等 |
| 文件名 | SKILL.md | SKILL.md 或 <name>.md |
分发
通过 pi-packages 打包后可发布到 npm 或 git 供他人安装。
注：Skills 中的指令可以引导模型执行任意操作（包括运行可执行文件），安装第三方 skills 前请审查内容。