从零打造你的AI技能:pi-skills开发者指南——编写第一个SKILL.md的完整步骤【免费下载链接】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 打造的开源 AI 技能库,兼容 Claude Code 与 Codex CLI,让你用一份 SKILL.md 就能教会 AI 一项新本领。本指南带你从零开始,掌握编写第一个 SKILL.md 的完整步骤,轻松扩展你的 AI 编程助手。 什么是 pi-skills?为什么你需要它pi-skills 把技能做成一个个独立文件夹,每个技能的核心是一份SKILL.md文件——相当于写给 AI 的操作说明书。AI 读到说明后,就能调用对应的脚本或命令完成任务。仓库内置了 8 个实用技能,覆盖搜索、浏览器自动化、Google 办公三件套、语音转文字等常见场景:技能用途参考文档brave-search网页搜索与内容提取brave-search/SKILL.mdbrowser-tools浏览器自动化browser-tools/SKILL.mdgccliGoogle 日历管理gccli/SKILL.mdgdcliGoogle 云盘管理gdcli/SKILL.mdgmcliGmail 邮件管理gmcli/SKILL.mdtranscribe语音转文字transcribe/SKILL.mdvscodeVS Code 集成vscode/SKILL.mdyoutube-transcript获取 YouTube 字幕youtube-transcript/SKILL.md 第一步:获取 pi-skills 技能库动手前先拿到技能库作为参考。在终端执行以下命令(使用官方镜像地址):git clone https://gitcode.com/gh_mirrors/pi/pi-skills ~/pi-skills更多安装与配置说明见 README.md。 第二步:读懂 SKILL.md 的黄金结构打开任意一个技能(例如 brave-search/SKILL.md),都能发现固定的三部分:YAML 头(frontmatter):用---包裹,声明技能名和描述,是 AI 识别技能的身份证标题与说明:告诉 AI 这个技能解决什么问题使用指南:具体命令、参数与示例,AI 照着执行即可标准模板长这样:--- name: 你的技能名 description: 一句简短描述,会展示给 AI --- # 使用说明 详细说明写在这里…… 辅助文件路径:{baseDir}/{baseDir}是占位符,运行时会自动替换成技能文件夹的真实路径,这样脚本无论放在哪里都能被准确找到。✍️ 第三步:编写你的第一个 SKILL.md以查询天气为例,跟着四步走:1. 创建技能文件夹在技能目录下新建一个文件夹,文件夹名即技能名:my-weather/ ├── SKILL.md └── weather.sh # 可选的辅助脚本2. 写好 YAML 头--- name: my-weather description: 查询指定城市的实时天气,当用户询问天气时使用。 ---⚠️ 两个要点:name必须和文件夹名一致;description决定 AI 何时调用它,记得写清做什么 何时用。3. 补充使用说明把 AI 需要执行的命令、参数、输出格式都写清楚,可参考 transcribe/SKILL.md 这种极简写法。4.(可选)添加辅助脚本如果需要执行外部逻辑,把脚本放进技能目录,用{baseDir}/脚本名引用即可,例如 brave-search/search.js 和 transcribe/transcribe.sh。 第四步:安装到正确的技能位置技能必须放在工具能扫描到的路径下,不同工具目录各不相同:工具用户级路径项目级路径pi-coding-agent~/.pi/agent/skills/.pi/skills/Codex CLI~/.codex/skills/-Claude Code~/.claude/skills/.claude/skills/Amp~/.config/amp/tools/-Droid~/.factory/skills/.factory/skills/ Claude Code 只扫描一层目录,记得把技能文件夹直接放在 skills 目录下。把上一步的文件夹复制(或软链接)到对应位置,重启 AI 工具即可生效。 进阶:从优秀案例中学习写法仓库里每个技能都是绝佳的教材,建议按难度顺序学习:入门:youtube-transcript/SKILL.md —— 结构最简洁,适合照葫芦画瓢进阶:brave-search/SKILL.md —— 包含 Setup、参数说明与输出格式高阶:browser-tools/SKILL.md —— 附带完整的效率指南教学✅ 最佳实践清单✅ 技能名用短横线小写(如my-weather)✅description同时写做什么和何时用✅ 所有脚本路径统一用{baseDir}/引用✅ 需要 API Key 时,写清配置步骤(参考 transcribe/SKILL.md)✅ 说明里给出示例命令和输出格式,AI 执行更准确按照这份指南,你已经能独立打造属于自己的 AI 技能了。现在动手,把第一个 SKILL.md 写起来吧!【免费下载链接】pi-skillsSkills for pi coding agent (compatible with Claude Code and Codex CLI)项目地址: https://gitcode.com/gh_mirrors/pi/pi-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考