agentskills 是什么?

agentskills/agentskills 是 Agent Skills 这个开放标准的官方规范与文档仓库——给 AI agent 增加新能力和专业知识的标准化方式。一个 skill 就是一个含 SKILL.md 的文件夹:SKILL.md 至少有 name/description 元数据 + 指令,告诉 agent 怎么完成某项任务,还可捆绑 scripts、references、templates 等资源。这套格式最初由 Anthropic 开发并作为开放标准发布,现已被大量 agent 产品采用。本仓库提供规范、文档站(agentskills.io)、技能创建指南、客户端展示与一个参考实现(skills-ref)。Apache-2.0(代码)+ CC-BY-4.0(文档)。它不是一个工具,而是整个『Agent Skill 生态』的地基。

⭐ 15,837 Stars 🍴 927 Forks Python Apache-2.0 作者: agentskills
来源:README What are Agent Skills/Open development;GitHub desc,license Apache-2.0 查看 GitHub 仓库 →

为什么值得关注

约 1.92 万星,热度因为它是『Agent Skills』这个正在爆发的标准的源头:本批趋势里大量项目(科研技能库、PPT/GEO/广告技能、pua 等)都基于 SKILL.md 格式,而这个仓库就是定义该格式的官方规范。Anthropic 起草、开放成标准、被众多 agent 产品采纳——想理解或实现 Agent Skills 的人都会回到这里,标准本身的中立与广泛采用是其影响力来源。

来源:GitHub 19,207 stars / 1,175 forks,created 2025-12-16;README Open development

核心功能

SKILL.md 文件夹格式

skill 是一个文件夹:必需 SKILL.md(元数据 name/description + 指令),可选 scripts/(可执行代码)、references/(文档)、assets/(模板资源)及任意附加文件——把过程性知识与上下文打包成可移植、可版本控制的单元。

来源:README What are Agent Skills
渐进式披露(三阶段)

discovery(启动时只载入每个 skill 的 name+description,刚够判断何时相关)→ activation(任务匹配描述时才把完整 SKILL.md 读入上下文)→ execution(按指令执行、按需跑捆绑代码或加载引用文件),让 agent 能挂很多技能而上下文占用很小。

来源:README How do Agent Skills work
可移植、可复用、可审计

把领域专长(法律评审、数据分析管线、排版等)、可重复工作流和公司/团队/用户特定上下文打包进 portable、版本化的文件夹,agent 按需加载;一次构建,可在任意兼容 skills 的 agent 上复用。

来源:README Why Agent Skills
开放标准 + 广泛采用

格式由 Anthropic 开发并作为开放标准发布,被大量 AI 工具/agentic 客户端支持(见 Client Showcase);标准开放给生态贡献。

来源:README Where can I use/Open development
规范、文档与参考实现

仓库含完整规范(specification)、agentskills.io 文档站(指南/教程/skill 创建/客户端展示)、以及 skills-ref 参考实现(Python,带测试),并指向 Anthropic 的 example skills。

来源:README Getting started;tree(docs/、skills-ref/)

技术架构

这是一个标准/文档仓库(非应用),三块构成:①规范本身(docs/specification.mdx 定义 SKILL.md 格式、元数据、渐进式披露等);②文档站 docs/(agentskills.io 的源,含 home/clients/skill-creation/client-implementation/snippets,用 mdx + docs.json 组织);③skills-ref/(Python 参考实现,src + tests + pyproject/uv,供客户端实现者对照)。skill 格式本身极简——一个含 SKILL.md 的文件夹 + 可选 scripts/references/assets。它定义的是『agent 如何发现、激活、执行技能』的契约,而真正的技能由生态各方按此格式编写(如本批里的众多 SKILL.md 项目)。整体是『格式规范 + 文档站 + 参考实现』的开放标准工程,价值在于被广泛采用的中立契约,而非某个具体能力。

来源:README Getting started/How do Agent Skills work;tree(docs/specification.mdx、skills-ref/src)

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) SKILL.md 格式(name/description + 指令 + scripts/references/assets)SKILL.md 格式(… 渐进式披露机制 skills-ref(Python 参考实现)skills-ref(Py… Mintlify/MDX 文档站Mintlify/MDX… SKILL.md 文件夹格式 渐进式披露(三阶段) 可移植、可复用、可审计 开放标准 + 广泛采用 规范、文档与参考实现 agentskills 项目本体 核心功能 关键依赖

中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言Markdown/MDX(规范与文档)+ Python(参考实现)框架开放标准(SKILL.md 格式)
SKILL.md 格式(name/description + 指令 + …渐进式披露机制skills-ref(Python 参考实现)Mintlify/MDX 文档站
无运行时;规范被各 agent 客户端实现并加载 skill 文件夹
来源:README Getting started;tree(docs/、skills-ref/)

快速上手

想用 Agent Skills:在支持的 agent 里加载 skill 文件夹即可(各客户端见 agentskills.io/clients)。想写 skill:建一个含 SKILL.md(写好 name/description 与指令)的文件夹,按需加 scripts/references/assets,参考 agentskills.io 的 skill-creation 指南与 Anthropic 的 example skills(github.com/anthropics/skills)。想实现客户端或对照行为:看 specification 与 skills-ref 参考实现。文档站 agentskills.io 有完整指南与规范。
来源:README Getting started/Where can I use

使用场景

适合:①想理解 Agent Skills 到底是什么、如何工作(发现/激活/执行)的开发者;②要写符合标准的 skill、或想让自己的 agent 产品兼容该格式(按规范 + 参考实现实现)的人;③想看哪些客户端支持、找示例 skill 的人;④研究 agent 能力扩展/上下文工程标准的人。不适合:想要现成可用技能本身的人(这里是规范,技能在各自仓库,如 Anthropic 的 skills 示例库);以及不关心标准、只想用某个具体 skill 的终端用户。

来源:README What are/How do/Getting started,结合定位推断

优势与局限

优势

  • 是地基级标准:本批大量 skill 项目都基于它,定义了 SKILL.md 这个被广泛采用的格式
  • 设计简洁有效:一个含 SKILL.md 的文件夹 + 渐进式披露,既好写又省上下文
  • 可移植可复用:一次构建跨任意兼容 agent 用,过程性知识/上下文可版本化
  • 开放中立:Anthropic 起草后作为开放标准、被众多产品采纳,并开放生态贡献
  • 配套完整:规范 + 文档站 + Python 参考实现 + 客户端展示 + 示例,便于实现与学习

局限

  • 本身是规范/文档,不提供可用技能或运行时,价值靠生态采用而非自身功能
  • 想要现成能力的人需另找具体 skill 仓库(如 Anthropic skills),这里不是技能库
  • 标准的实际一致性取决于各客户端实现,不同 agent 对 skill 的支持深浅可能有别
  • skill 会执行捆绑代码,安全性由加载它的 agent/用户负责(标准层面不强制沙箱)
  • 作为标准仍在演进,规范细节与生态采纳度仍会变化
来源:README What are/Open development;标准的固有性质推断

最新版本

仓库以规范 + 文档 + 参考实现形式维护,无传统 GitHub Release,最近 push 2026-05-20(创建于 2025-12-16)。格式由 Anthropic 发布为开放标准后被持续采纳,规范与客户端展示随生态扩充,处于活跃演进、被广泛采用的阶段。

来源:GitHub pushed_at 2026-05-20;README Open development

总结评价

agentskills/agentskills 不是一个工具,而是整个『Agent Skills 生态』的地基:它定义了 SKILL.md 这个极简却有效的格式——一个含 SKILL.md 的文件夹 + 渐进式披露,让 agent 能挂很多技能又不撑爆上下文,由 Anthropic 起草、开放成标准、被大量 agent 产品采纳。本批趋势里那么多 skill 项目都建在它之上,1.92 万星更多是对这个中立标准影响力的认可。要清楚它的定位:这里是规范、文档和参考实现,不是可用技能本身(要现成能力得去 Anthropic 的 skills 示例库或各专门仓库)。对想理解、编写符合标准的 skill 或让产品兼容该格式的开发者,这是必读的源头;只想用某个具体 skill 的终端用户则不必直接看它。

来源:综合 README 定位/格式/开放标准、tree(规范+参考实现)、生态地基性质的事实判断
透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-05-23 16:57. 质量评分: 100/100.

数据来源:README、GitHub API、依赖文件