如何提交你的第一个AI技能：agent-toolkit贡献者完全指南

如何提交你的第一个AI技能agent-toolkit贡献者完全指南【免费下载链接】agent-toolkitA curated collection of skills for AI coding agents. Skills are packaged instructions and scripts that extend agent capabilities across development, documentation, planning, and professional workflows.项目地址: https://gitcode.com/gh_mirrors/agentt/agent-toolkitagent-toolkit 是一个 AI 技能Agent Skills开源仓库汇集了 40 个可即插即用的技能包覆盖开发、文档、规划和职业工作流。本文将带你从零开始用最短路径提交你的第一个 AI 技能Skill成为 agent-toolkit 的贡献者。整个过程不需要任何机器学习背景——AI 技能本质上就是打包好的 Markdown 指令会写文档就能贡献。1分钟了解AI技能到底是什么很多人以为给AI加技能需要训练模型。其实恰恰相反技能不是代码它是一个文件夹核心是一份 SKILL.md用自然语言告诉AI遇到这类任务时该怎么想、怎么做即改即生效编辑保存后下一次调用就生效零成本、零部署专家知识外化技能的价值在于沉淀只有老手才知道的判断树、取舍和反模式而不是重复AI已经会的基础知识仓库里现成的技能就是最好的教材比如技能用途参考价值humanizer去除文本中的AI腔结构最完整含24个模式示例commit-work高质量Git提交典型的检查清单式写法skill-judge给技能打分直接讲什么算好技能动手前克隆仓库并熟悉结构在仓库根目录你会看到清晰的分区skills/ # 技能包本次贡献的主战场 agents/ # 子智能体定义 commands/ # 斜杠命令 scripts/ # 构建与版本脚本先克隆仓库到本地在终端执行git clone https://gitcode.com/gh_mirrors/agentt/agent-toolkit cd agent-toolkit然后重点阅读两份文档贡献规范CONTRIBUTING.md项目总览与技能清单README.md一个合格AI技能的4件套每个技能是一个独立目录标准结构如下skills/你的技能名/ ├── SKILL.md # 必选给AI看的操作指令 ├── README.md # 必选给人类看的文档 ├── scripts/ # 可选自动化辅助脚本 └── references/ # 可选补充参考资料以 crafting-effective-readmes 为例它把主指令写在SKILL.md细节资料放在references/和templates/子目录按需加载——这就是官方推荐的组织方式。SKILL.md 怎么写文件顶部必须有 YAML frontmatter这是技能被识别的关键--- name: 你的技能名 description: 一句话说明技能做什么、什么时候该用它 ---正文部分记住三条铁律详见 CONTRIBUTING.md 的 Code Style 一节用祈使句写指令动词开头像给下属下命令而不是聊天只写增量知识——AI已经会的不写把篇幅留给专家经验给出具体步骤和示例而不是检查错误修复配置这类空话拿不准时对照 skill-judge 的评分维度自查一遍。本地测试你的AI技能提交PR前务必在本地跑通。agent-toolkit 支持一行命令把本地技能装进你的AI编码工具npx skills add . --skill 你的技能名装好后直接让AI调用它观察行为是否符合预期。发现偏差就改SKILL.md再重装再测——这个测试-修改循环是贡献被顺利合并的最大保障。提交PR的3个步骤建分支从main拉出特性分支命名feat/你的技能名git checkout -b feat/my-skill更新README在主 README.md 的技能表格中为你的技能加一行链接——这一步很多新手会漏掉提交PR在描述里写清楚技能做什么、解决什么问题、怎么测的提交时遵循约定式提交格式例如git commit -m feat: add my-skill提高合并概率的4个技巧先找同类在skills/里找一个结构最接近你想法的技能照着搭比如 command-creator 展示了主指令 references 参考资料的标准分层命名清晰技能名用短横线小写kebab-case见名知义脚本要聚焦如确实需要脚本保持单一职责并加注释可参考 scripts/build_plugins.py 的注释风格用仓库自带工具如果涉及插件化plugin-forge 自带脚手架和版本脚本能省去大量手动配置常见问题Q我只会写文档不懂编程能贡献吗完全可以。技能的核心是 Markdown 指令writing-clearly-and-concisely 这类纯写作技能就是明证。Q技能要覆盖多复杂的功能一个技能解决一类问题即可。宁可小而专不要大而全。Q提交后多久会有反馈保持PR描述完整做什么/怎么测/截图维护者审核效率会高很多。下一步行动清单✅ 克隆仓库通读 CONTRIBUTING.md ✅ 挑一个你日常痛点仿照现有技能搭好skills/你的技能名/目录 ✅ 写完SKILL.mdREADME.md本地跑通测试 ✅ 更新主 README提交PR你的第一个AI技能距离合并可能只差一次认真自查。现在就从克隆仓库开始吧【免费下载链接】agent-toolkitA curated collection of skills for AI coding agents. Skills are packaged instructions and scripts that extend agent capabilities across development, documentation, planning, and professional workflows.项目地址: https://gitcode.com/gh_mirrors/agentt/agent-toolkit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考