★ FEATURED ARTICLE 【免费下载链接】thepopebotThe Pope Bot is an autonomous AI agent that you can configure and build to do just about anything you want, all day, everyday, 24/7.项目地址https://gitcode.com/gh_mirrors/th/thepopebot点击查看免费下载thepopebot 是一款可以 24/7 全天候运行的自主 AI Agent 平台而「技能Skills」就是为它扩展能力的最简单方式——写一个SKILL.md再建一条软链接你的 Agent 立刻学会一项新本领。本文从技能的双目录原理讲起带你一步步完成 SKILL.md 编写、脚本打包、软链接激活和禁用回滚全程不需要编译、不需要注册新工具。thepopebot 技能Skill是什么一个技能就是一个文件夹里面包含一个SKILL.md说明文件外加可选的脚本文件skills-library/my-skill/ ├── SKILL.md # 给 Agent 看的说明书 ├── run.sh # bash 脚本最常见 └── package.json # 仅 Node.js 依赖时才需要技能的核心特点是按需加载渐进式披露系统提示词里只写入每个技能的「名称 一句话描述」Agent 判断某个技能和当前任务相关时才会去读取完整的SKILL.md并执行脚本。也就是说装几十个技能也不会显著占用上下文。另一大优势一套技能所有 Agent 通用。thepopebot 通过各 Agent 专属的软链接桥.claude/skills、.pi/skills、.codex/skills、.gemini/skills、.kimi/skills→../skills共享同一个skills/目录你在 Claude Code、Codex、Gemini CLI 之间切换时技能自动跟着走。为什么要有两个目录skills-library 与 skillsthepopebot 刻意把技能拆成两个目录各司其职目录角色说明skills-library/name/ 规范存储Source of Truth存放所有 SKILL.md 和脚本禁用技能也不会删除这里skills/name️ 激活面Activation Surface每条记录都是一条指向../skills-library/name的软链接这样设计的好处是开关技能极其廉价✅ 激活 建一条软链接✅ 禁用 删掉软链接源码原封不动随时可再激活✅ 无需复制、归档也不会产生删除即丢失的风险两个目录的官方说明分别在 templates/skills-library/CLAUDE.md.template 和 templates/skills/CLAUDE.md.template建议各读一遍。编写 SKILL.mdfrontmatter 是灵魂每个技能必须有SKILL.md结构分两部分YAML frontmatter元数据Markdown 正文完整用法。--- name: my-skill description: 一句话说明技能做什么、什么时候用。 --- # My Skill ## Setup 需要 MY_API_KEY 环境变量。 ## Usage skills/my-skill/run.sh 参数三条关键规则name用 kebab-case且必须与文件夹名一致description要短促、面向行动——它会被渲染进系统提示词的 Active skills 区块是 Agent 决定要不要用这个技能的唯一依据写得越精准触发越可靠正文里的路径一律用项目根相对路径skills/my-skill/...Agent 看到的是软链接路径不要写skills-library/...。一个真实参考内置的 templates/skills-library/agent-job-background/SKILL.md 的 description 甚至列出了触发短语create a background job、check job status让 Agent 在用户说出特定措辞时精准命中——这是很值得借鉴的写法。编写技能脚本bash 优先官方约定是Bash first技能本质是胶水代码——调 API、搬数据、处理文件bash curl配合 python3 处理 JSON能覆盖绝大多数场景。bash 脚本以#!/bin/bash开头并加set -euo pipefail创建后记得chmod x仅在依赖库没有替代方案时才用 Node.js比如需要特定 npm 包做 HTML 解析此时附一个package.json声明依赖Docker 环境会在 entrypoint 中自动安装⚠️ 根目录package.json是type: moduleNode 脚本请命名为.cjsCommonJS或.mjsESM不要用裸.js否则会被静默破坏。一个典型的 bash 技能脚本以语音转写为例完整案例见 docs/HOW_TO_BUILD_SKILLS.md#!/bin/bash set -euo pipefail if [ -z $1 ]; then echo Usage: transcribe.sh audio-file; exit 1; fi if [ -z $GROQ_API_KEY ]; then echo Error: GROQ_API_KEY not set; exit 1; fi curl -s -X POST https://api.groq.com/openai/v1/audio/transcriptions \ -H Authorization: Bearer $GROQ_API_KEY \ -F file${1} \ -F modelwhisper-large-v3-turbo \ -F response_formattext软链接激活技能一条命令搞定这是整个流程最关键、也最简单的一步。在项目根目录执行# 1. 给脚本加执行权限 chmod x skills-library/my-skill/run.sh # 2. 建立软链接激活技能 ln -s ../skills-library/my-skill skills/my-skill完成后 Agent 就能通过skills/my-skill/run.sh调用它了。禁用时只需删除软链接rm skills/my-skill # 源码在 skills-library/ 中原封不动 关于npx thepopebot init它只在首次安装时为所有内置技能批量创建激活软链接之后的每次升级新内置技能都会以「未激活」状态落在skills-library/里由你自己决定是否建链接——这让你始终掌握技能开关的主动权。内置的 4 个默认技能首次安装后自动激活的内置技能既是开箱即用的能力也是现成的学习范本技能能力agent-job-secrets列出/获取 agent-job 密钥与 OAuth 凭据自动刷新agent-job-dm列出用户、通过默认渠道发私信或广播agent-job-background在后台派生新的 agent job 并查询状态playwright-cli浏览器自动化它们的源码模板位于 templates/skills-library/比如浏览器自动化技能 templates/skills-library/playwright-cli/SKILL.md 就演示了如何把几十个 CLI 子命令组织成清晰的分节文档。运行时是如何发现你的技能的技能加载由{{skills}}模板变量驱动解析逻辑在 lib/utils/render-md.js它会扫描skills/目录跟随软链接进入skills-library/提取每个SKILL.mdfrontmatter 中的description注入到系统提示词里。以 agent-job 为例templates/agent-job/SYSTEM.md 的 Active Skills 区块末尾就是一句{{skills}}运行时自动展开。完整链路只有 4 步渲染器扫描skills/把各技能描述放进系统提示词用户提出请求Agent 根据描述判断技能相关Agent 读取完整SKILL.md学习命令Agent 通过软链接路径执行脚本读取输出并回复。常见问题与注意事项❌不要把真实文件直接放进skills/——那里只放软链接真实文件一律放skills-library/技能需要 API Key在管理后台 Admin Event Handler Agent Jobs 里添加 secret它会被注入为 Docker 容器的环境变量配合agent-job-secrets技能Agent 还能自行发现可用密钥安全提示技能通过 bash 运行Agent 理论上能读取环境变量。带AGENT_前缀的受保护密钥会被 env-sanitizer 过滤无法在 bash 中直接读取放心使用即可 修改技能结构后顺手更新根目录的CLAUDE.md让下一个接手的 Agent 看到准确的实例地图。参考资料技能开发完整文档docs/HOW_TO_BUILD_SKILLS.md规范存储目录说明templates/skills-library/CLAUDE.md.template激活面目录说明templates/skills/CLAUDE.md.templateAgent 运行时环境约定templates/agent-job/SYSTEM.md技能描述渲染实现lib/utils/render-md.js写一个SKILL.md、建一条软链接五分钟就能给你的 thepopebot 装上一项新技能——去skills-library/里动手试试吧。赞分享【免费下载链接】thepopebotThe Pope Bot is an autonomous AI agent that you can configure and build to do just about anything you want, all day, everyday, 24/7.项目地址https://gitcode.com/gh_mirrors/th/thepopebot点击查看免费下载相关推荐如何为 Jan Agent 编写 SKILL.md 可复用技能如何为 Jan Agent 编写 SKILL.md 可复用技能 如果你在 Jan Agent 里反复粘贴同一段流程说明——比如怎么打 release怎么人工智能AI 应用大模型本地部署桌面应用交互助手AI Agent如何快速激活IDMIDM激活脚本完整指南如何快速激活IDMIDM激活脚本完整指南 还在为Internet Download Manager的试用期烦恼吗想要永久享受高速下载却不知从何入手这个简单CLI告别一人远程他人掉线的尴尬RDPWrap.ini 多用户连接从零到一实战手记告别一人远程他人掉线的尴尬RDPWrap.ini 多用户连接从零到一实战手记 远程桌面用得好好的忽然被另一个登录者一脚踢出——Windows 家用版默认只允创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
