到了 2026 年,Agent Skills 已经成为 Harness setups 中不可或缺的一部分,它们为 Agents 提供了运行得更高效、更有效所需的精确能力。这推动了 skill 开发的爆炸式增长,并进一步催生了 skills registry 和 marketplace。
截至本文写作时,仅 Skills.sh registry 就已经托管了 1,176,408 个 agent skills。像 SkillsMP、ClawHub、LobeHub Skills 和 agentskill.sh 这样的其他平台,也在托管数十万个 agent skills。
面对如此庞大的 skill 数量,我有时会觉得筛选这些长列表、阅读评测和讨论、最终找到一个真正有价值、能显著提升 agent 在特定任务上表现的合适 skill,是件很耗时的事。
所以我想和你分享一些我测试过一段时间,并决定保留在我的 agent skills 收藏中的 skills。
在这篇文章里,我们会先简要拆解一下 agent skills 是什么、为什么你应该使用它们,然后再进入我的 Top 10 Agent Skills 列表,其中主要是今天开源社区里可获得的独立 skills。
什么是 Agent Skills?
Agent skills 本质上就是包含结构良好、专业化指令的 markdown 文件,它们会作为面向 AI coding agents 的定向 prompts。
一个定义良好的 agent skill 应该包含以下内容:
何时使用该 skill
应遵循什么 workflow
规则和约束
分步骤流程
相关领域知识
需要检查哪些文件/资源
示例和模式
有时还包括 scripts、templates 或其他支持文件
不过,单个 Markdown 文件很快就会变得很庞大。这就是为什么你会发现有些 skills 被定义成 packages。比如,以下是 Anthropic 的 skill-creator skill 所描述的 skill 结构:
skill-name/
├── SKILL.md (required)
│ ├── YAML frontmatter (name, description required)
│ └── Markdown instructions
└── Bundled Resources (optional)
├── scripts/ - Executable code for deterministic/repetitive tasks
├── references/ - Docs loaded into context as needed
└── assets/ - Files used in output (templates, icons, fonts)
采用这种结构在 context engineering 中被证明是有效的,因为 skills 会按照三层加载系统逐步加载到 context 中:
Metadata(name & description):始终在 context 中(约 100 words)
SKILL.md body: 当 skill 触发时进入 context(理想情况下少于 500 lines)
Bundled resources: 按需加载(数量不限,scripts 甚至可以在不加载的情况下直接执行)
agent skills 的可移植性和高效率,是它们在 vibe coders 和 agentic engineers 中非常流行的主要原因。
使用 Agent Skills 的好处
除了可移植性和效率之外,agent skills 还有一些其他优势。
1. 一致性与方法论
在软件开发中,我们通常依赖既定的模式和流程,比如 Test-Driven Development (TDD) 中的 Red-Green-Refactor (RGR) 循环。
但由于 AI coding agents 并没有针对任何特定开发流程进行优化,而底层 LLM 又是通过 next-token generation 直接解决问题来训练的,所以我们可以预期这些 agents 会默认采用“implementation-first”或“code + test simultaneous”的 workflow,而不是严格的 RGR 循环。
通过使用 skills,我们可以把这类流程制度化,防止 AI 走偷懒的捷径,并强制它每次都遵循严格、可靠的方法论。
2. 防止“平庸”输出
LLMs 是在整个公共互联网语料上训练的。这意味着它们的默认输出未必是最优的,其中可能包含不良实践、旧代码和已弃用的 libraries。
Agent skills 可以通过精心设计的指令来覆盖这种基线,强制 agent 绕过其通用训练结果,严格遵循良好的 coding standards。
3. 团队对齐与标准化
当一个 engineering team 采用共享的 agent skills repository 时,每位开发者的 AI assistant 都会在完全相同且严格的 engineering guidelines 下运行。
这就确保了无论是 junior developer 还是 senior architect 在使用 AI coding agent,生成的代码都会遵守团队的 architecture principles、命名规范和 tooling standards。
关于避免 Skill Misuse 的说明:
在介绍我的 top skills 列表之前,我想先谈谈如何 不要 使用它们。很容易陷入 skill overload 的陷阱,而这实际上会降低 agent 的性能。
不要一次加载太多 skills: agent skills 背后的整个理念就是 modularity 和合理的 context optimization。skills 设计上就是要按需、渐进式加载的。如果你同时触发五六个庞大的 skills,你其实只是把一大堵文本墙塞进了 context window。我想这显然不是好做法。
不要把 skills 用作全局规则(请使用
AGENTS.md): 并不是所有东西都需要作为一个被触发的 skill。agent 需要 始终 遵守的基础规则、coding standards 和 guardrails,应该直接写在项目的AGENTS.md里。
例如,“Git Workflow” 指南就不应该做成 skill。agent 在几乎每个任务中都会用到 Git,因此没有必要每次都为它触发一个 skill。把它放进基础AGENTS.md文件里即可,这样它就会始终存在于背景 context 中。要知道何时该改用 Specialized Agent: skills 非常适合为你的主 coding agent 增加特定能力。不过,如果某个特定任务需要长达数页、极其复杂且逐步展开的指令,把这些内容硬塞进单个
SKILL.md就是个错误。
在这种情况下,更好的做法是创建一个专用 agent(拥有自己的 system prompt、工具权限和隔离的 context window),而不是用一本小说长度的指令去淹没你的主 builder agent。保持 skills 的模块化,把超大 workflow 委派给专用 agents。
我的 Top 10 Agent Skills 列表
下面是我整理的 Top 10 agent skills,它们帮助我提升了 coding agent 的性能和效率。
在某些情况下,我会把多个 skills 放在一个条目下。主要是因为某个 skill 依赖于其他多个 skills,或者多个 skills 在同时触发时配合得很好。
1. Systematic Debugging (obra/superpowers pack)
这个 systematic-debugging skill 强制执行一条重要的调试原则:
NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST.
这是一条在 AI agents 上做 debugging 时极其关键的规则,因为在很多情况下,agents 往往修复的是症状,而不是根因。使用这个 skill 时,agent 会经历 4 个阶段:
正确阅读错误并复现它。
找到一个可工作的示例进行对比。
提出一个假设并进行最小化验证。
实现解决方案。
我在 agent response 中最讨厌看到的调试行为主要有两种:
问题大概是……让我用……来修复一下。
(在已经提出多个失败修复方案之后)现在这是核弹级修复。
这说明 agent 只是在照常猜测,而没有遵循良好的 debugging 方法论。
2. Test-Driven Development (obra/superpowers pack)
这个 skill 强制执行我们在上一节提到的严格 Red-Green-Refactor 循环。它通过指示 agent 先编写一个定义目标行为的 failing test 来工作。在测试失败之前,它被明确禁止编写 implementation code。然后,它只编写让测试通过所需的最少代码,最后再进行 refactor。
这个 skill 对小型项目来说可能看起来有些过度,但在需要稳健结果、且代码库必须高度可测试并具有高覆盖率的专业环境中,更严格的开发方式是必要的。这个 skill 通过强迫 AI 在写下任何一行 implementation code 之前,就考虑 edge cases、error states 和 API contracts,帮助实现这一点。
3. Frontend Design (Anthropic) & Design Taste Frontend (Leonxlnx)
Links: Design Frontend Design ([Github](https://github.com/Leonxlnx/taste-skill/blob/main/skills/taste-skill/SKILL.md), [Skills.sh](https://www.skills.sh/leonxlnx/taste-skill/design-taste-frontend)), Taste Frontend (Github, Skills.sh).
AI 有能力生成出色的 UI,但如果你让 coding agent 来做,十有八九会得到一个毫无新意、缺乏灵感的通用 UI,远远达不到你的预期。
这就是所谓的“AI slop”——那种从字体选择、颜色、布局到结构都在大喊“我是 AI 做的”的外观,一切都显得毫无灵魂。
同时使用这两个 skills,会把 agent 变成一位有品位的创意总监。
Anthropic 的
frontend-designskill 指示 agent 拒绝模板化默认方案,而是对色板、排版和布局做出有意识、带有明确偏好的选择。这个 skill 明确要求 agent 基于应用的具体主题,“做出一个你可以为之辩护的真实审美冒险”。Leonxlnx 的 “Anti-Slop” skill 编写得很好,几乎涵盖了 frontend design 的方方面面,并作为严格的执行者。它指示 agent 阅读你的 brief,并推断出你真正想要的准确 vibe。它还为 design variance 和 motion intensity 配置了调节旋钮,并禁止已知的 LLM 痕迹(例如在 marketing copy 中使用 em-dash,或使用千篇一律的 glassmorphism)。它甚至会在允许代码发布之前,强制 agent 通过一个严格的 50 项 pre-flight checklist。
4. Vercel React Best Practices (vercel-labs/agent-skills)
到目前为止,我提到的这些 skills 都是关于流程的,而这个则纯粹是参考规范。如果你在项目中使用 Next.js 或 React,这个 skill 非常重要。
它由 Next.js 的创建者 Vercel 维护,包含 70 多条高影响力规则,并按优先级分类。每条规则都配有错误示例和正确示例,涵盖 Promise.all 替代顺序 await、避免会导致 bundle 变大的 barrel-file imports,以及绝不在另一个 component 内定义 component 等内容。
这个 skill 完全属于技术规范,它能确保你的 Next.js applications 默认就具备良好性能,从而减少优化循环和 token 使用量。
5. Brainstorming & Writing Plans (obra/superpowers pack)
Links: Brainstorming ([Github](https://github.com/obra/superpowers/blob/main/skills/brainstorming/SKILL.md), [Skills.sh](https://www.skills.sh/obra/superpowers/brainstorming)), Writing Plans (Github, Skills.sh).
默认情况下,AI agents 天生就倾向于取悦用户。如果你告诉一个 agent:“我需要一个处理用户登录的系统”,它会立刻开始写代码,而不是先问你是否真的需要 OAuth、session tokens,还是像 Clerk 或 Auth0 这样的第三方 provider。现在我知道有 planning agents,但有了这个 skill,即使你忘了把开关切到 planning agent,并让 builder agent 实现一个新功能,它也会强制 agent:
提出澄清问题。
提出两到三个方案,并给出明确推荐。
分部分展示设计,并在每一部分都获得确认。
将其写入 spec 文件并提交。
调用
writing-plansskill,把已批准的 spec 转换为逐步的待办清单。
除了防止 agent 直接急着实现之外,这个双 skill 组合还会迫使你更认真地思考系统设计和你想包含的功能。这样你可以最大限度地降低遇到根本性架构缺陷的风险。
6. Modern Python (trailofbits/skills)
搭建新的 Python 项目有多种方式,从管理 virtual environments 到选择合适的工具都包含在内。对于 virtual environments,你可以使用内置选项如 venv,也可以使用第三方工具如 virtualenv。对于 package management,常见选择包括 pip、poetry 或 conda。最后,对于 code quality 工具,你可以在 ruff、black 或 flake8 这类 linters 和 formatters 中进行选择。
这些都是社区中广泛采用、完全可行的选项,所以如果你已经有自己偏好的 stack,可以直接跳过这个 skill。不过,如果你想要一个现代化、带有明确意见的基础方案,又不想费劲地把一堆旧工具拼接起来,那么这个 skill 就非常适合你。
如果没有这个 skill,当你只是简单地让 AI agent "set up a new Python project" 时,它几乎肯定会默认使用一套旧式配置:pip、virtualenv、mypy 和 black。
这套 stack 虽然能用,但速度慢,而且过于零散。
这个由 Trail of Bits 的安全研究人员提供的 skill,会彻底覆盖这一基线。它指示 agent 采用现代、基于 Rust 的 Python toolchain。
它强制 agent 使用 uv 进行非常快速的依赖管理,使用 ruff 进行快速 linting 和 formatting,并采用现代的 pyproject.toml 配置。
这样,你就能让 Python 项目保持快速、整洁,并符合现代标准。
7. Security Review (getsentry/skills)
Links:Github, Skills.sh
众所周知,vibe coded applications 往往是安全噩梦,这并不是因为开发者没有要求进行 security audit 和 review。更主要的原因是,当你让 agent “检查漏洞”时,它会标记无害代码,并花费成千上万的 tokens 去抱怨那些毫无结果的理论问题。
基于 OWASP Cheat Sheet Series,Sentry 团队的这个 skill 强制区分“Research”和“Reporting”。agent 被允许研究 整个 codebase,以理解数据如何流动,但除非它对 attacker-controlled input 能够利用某个具体模式具有 HIGH CONFIDENCE,否则严格禁止报告任何问题。
这个 skill 真的能让 agent 表现得像一位有经验的 Application Security (AppSec) engineer。它会穿透噪音,给出简洁、可操作的实际可利用漏洞报告(例如 XSS、SQLi 或 SSRF),而不是让你淹没在那些你反正也会忽略的理论警告里。
8. The Grilling & Domain Modeling Suite (mattpocock/skills)
Links: Grill-me ([[[Github](https://github.com/mattpocock/skills/blob/main/skills/engineering/grill-with-docs/SKILL.md)](https://github.com/mattpocock/skills/blob/main/skills/productivity/grilling/SKILL.md)](https://github.com/mattpocock/skills/blob/main/skills/productivity/grill-me.md), [[[Skills.sh](https://www.skills.sh/mattpocock/skills/grill-with-docs)](https://www.skills.sh/mattpocock/skills/grilling)](https://www.skills.sh/mattpocock/skills/grill-me)), Grilling (Github, Skills.sh), Grill-with-docs (Github, Skills.sh), Domain-modeling (Github, Skills.sh).
只有当你想被你的 agent 盘问时才使用这些 skills。这不是开玩笑:如果你经常在没有完全理解业务领域的情况下就匆忙开始构建一个新功能,三周后却在处理松散抽象和强耦合逻辑,那么你需要的正是这套 skills。
这些 skills 属于 Matt Pocock 的 productivity 和 engineering skills suite。
Grilling 是一种不依不饶、一次只问一个问题的访谈流程,由
grill-me和Grill-with-docs共同触发。它会沿着决策树逐步推进,逐一解决依赖关系,为每个问题给出自己的推荐答案,并且在你真正达到共同理解之前绝不开始行动。Grill-me 只是它用于触发一次 grilling session 的手动入口。
Domain-modeling 用于防止项目词汇漂移,因此一旦你的用词与已经写下的内容不一致,它就会追问你到底指的是哪一个,并把真实决策记录成简短的 Architecture Decision Records。
Grill-with-docs 会把前两个结合起来,这样一次访谈结束后会留下 glossary 和书面记录,而不是在聊天窗口关闭后就消失。
9. Refactor (github/awesome-copilot)
随着 codebase 的老化,它们不可避免地会积累 “code smells”。
“A code smell is a surface indication that usually corresponds to a deeper problem in the system.” - Martin Fowler
这些设计缺陷会以多种形式出现:
重复逻辑。
过度膨胀的 classes。
过长的方法。
深层嵌套。
紧耦合。
在没有明确指示的情况下要求 AI “把这个整理一下”,某种程度上是在赌博。比如,它可能会导致逻辑损坏或业务规则被更改。
这个专门的 skill 完全专注于安全、保持行为不变的重构。它指示 agent 识别具体的 code smells,并应用 SOLID principles 和提取技术,同时 不 改变代码的外部行为。
它的黄金法则是:refactoring 改变的是代码的写法,而不是它做什么。
10. Web Quality Audit (addyosmani/web-quality-skills)
Addy Osmani 的这个 skill 基于 Lighthouse 和 Core Web Vitals。它会像 Lighthouse 一样,针对四个类别——performance、accessibility、SEO、best practices——执行 150 多项检查。
这个 skill 会把 agent 变成一个毫不留情的 QA auditor。它会在代码进入 production 之前,主动分析应用的 performance bottlenecks,检查是否存在过重且未优化的 images、阻塞渲染的 scripts,以及缺失的 ARIA labels。
我认为这个 skill 在 launch 之前至关重要,而且老实说,也很适合定期运行,因为这个 skill 本身就建议按 weekly 和 monthly 的节奏执行。
安全风险与供应链攻击
我上面列出的所有 skills 都经过了扫描和测试,但你在网上找到的任何 skill 并不一定如此。就像安装未知的 npm package 或 Python library 一样,下载随机的 agent skills 也会带来供应链风险。
由于 skills 本质上是设计为直接注入 AI context window 的 Markdown 文件,因此它们非常容易受到 prompt injection attacks 的影响。
例如,恶意行为者可能会发布一个看起来很有帮助的 “Database Optimization” skill,但其中实际上包含隐藏指令,有时会被埋在 HTML comments 或不可见的 Unicode 字符里。一旦 AI 读取了这个文件,被注入的 prompt 就可能覆盖你的原始指令,诱使 agent 执行有害的 shell commands,悄悄把你的 codebase 外传到远程服务器,或者泄露敏感的 environment variables 和 API keys。
为了防止这一切发生,请执行以下操作:
坚持使用可信来源: 始终验证 skill 的作者。上面 Top 10 中列出的 skills 由信誉良好的组织(如 Anthropic、Vercel、Trail of Bits 和 Sentry)或高度可信的社区成员维护。
使用安全的 registries: 如果你正在从像
skills.sh这样的开放 registry 中探索新 skills,请始终使用官方 CLI 工具(例如npx skills add)。这个工具不会只是盲目下载文件,它会在 skill 接触你的机器之前,提供一个由 Socket、Snyk 和 Gen 等行业标准安全扫描器驱动的内置 Security Risk Assessment。例如,当你通过 CLI 下载
grill-meskill 时,你会看到如下的安全报告:
o Security Risk Assessments ------------------------------+
| |
| Gen Socket Snyk |
| grill-me Safe 0 alerts Low Risk |
| |
| Details: https://skills.sh/mattpocock/skills |
| |
+----------------------------------------------------------+
所以,一定要查看这些风险评估,自己阅读原始 SKILL.md 文件,并在让你的 AI agent 在你的机器上运行之前,确保你完全理解自己授予了它哪些权限。

