跳转到正文
Agent 工程篇约 11 分钟
打开原图 ↗

Agent Skills ​

NOTE

一句话理解
Agent Skills 是可复用、可组合的最小能力模块:统一文件结构、按需加载,让智能体从「泛泛回应」变成「精准帮忙」——用来解决传统工具调用的上下文冗余与判断负担。

是什么 ​

定义:扩展智能体能力的规范方案。每个 Skill 是可单独使用、也可自由组合的最小能力模块;智能体按需加载、灵活调用,适配具体场景。

由来:Anthropic(Claude)率先提出。2025 年 10 月以实验功能上线,同年 12 月成为跨平台开放标准并开源;随后被 Cursor、VS Code Copilot 等采用,形成行业生态。

传统工具调用的痛点:

  • 上下文冗余、判断负担重
  • 工具难以复用、缺少统一标准

核心特点:

特点说明
原子化每个技能是最小能力模块,可单独使用、自由组合
规范化统一文件格式,保证兼容与复用
按需加载需要时才加载完整信息,不浪费上下文——与传统工具调用的核心区别

相对传统工具的优势 ​

两大收益:省 token、减轻判断负担。

三层渐进式披露(省 token) ​

Claude Code 官方明确的核心机制:技能信息分三层,按需逐步加载。

层级内容加载时机
第一层 · 元数据YAML 前置:名称、用途等摘要启动时始终加载,几乎不占资源
第二层 · 技能主体完整 SKILL.md(步骤与规则)判断与当前任务相关时
第三层 · 附加文件脚本、参考文档等执行复杂操作时(如跑 SQL、处理数据)

减轻判断负担 ​

传统方式下,智能体面对功能杂乱、可能重复的工具集,执行时还要费力筛选。Skills 把能力拆成独立小技能,每个只负责单一功能;执行时精准调用对应技能,上下文更清晰,任务更准、更快。

对比一览 ​

对比项传统方式Agent Skills
加载时机无论是否有用,提前加载全部完整信息按需分层(元数据 → 主体 → 附加)
Token易浪费、拖慢响应按需加载,减少重复与冗余
工具形态功能杂乱、可能重复原子化小技能,单一职责
判断负担需费力筛选合适工具精准调用对应技能

文件规范 ​

NOTE

核心约定:每个技能对应一个独立文件夹,内必须有 SKILL.md。文件含 YAML 前置(元数据) 与 Markdown 指令 两部分,缺一不可——这是「三层渐进式披露」和按需加载的基础。

text
skill/employees/
├── SKILL.md          # 元数据 + 详细指令
└── scripts/          # 第三层:附加脚本
    ├── execute_sql.py
    └── __pycache__/  # 自动生成,无需手建

目录统一:从配置地狱到 .agents/skills ​

Anthropic 的理念是「写一次,到处使用」。现实是各平台目录并不统一:

平台Skills 目录
Codex.codex/skills
Claude.claude/skills
Gemini.gemini/skills

要在多平台用同一套 Skills,只能复制文件、建符号链接,或写同步工具——「写一次」变成维护多份配置。GitHub Issue #15 里有人说得很直接:工具与通信层标准化了,指令与上下文的语义层还没有。

TIP

从倡议到落地,约一周
2026 年 2 月 3 日,OpenAI 的 Alexander Embiricos 倡议:各 Agent 统一读 .agents/skills,逐步废弃各自私有目录(Codex 已启用 .agents/skills)。随后 OpenCode、微软 Copilot CLI(0.401)、Gemini CLI、Cursor 等迅速跟进。主流平台响应不到一周。

本机多工具:skills.sh ​

skills.sh 解决「一个人、多工具」的目录同步:

shell
npx skills add vercel-labs/agent-skills

Skill 下载到 .agents/skills/,检测本机已装的 AI 工具(Claude、Cursor、Windsurf 等),在各自 Skills 目录创建指向 .agents/skills/ 的软链接。维护一份源文件即可。平台原生支持 .agents/skills 后,软链接会逐渐退出;skills.sh 默认落在 .agents 下,仍可继续用来发现与安装。

团队共享:TeamAI ​

多人要把 Skills / Rules / MCP / Agents 等资产统一分发,可用腾讯开源的 TeamAI:以 Git 仓库为底座,成员 teamai init 后自动拉取最新资产,覆盖 Claude Code、Codex、Cursor、CodeBuddy 等。

shell
npm install -g teamai-cli
# 或在 Agent 里安装 skill 后对话引导:
# Install the teamai skill: https://github.com/Tencent/teamai-cli/tree/main/skills/teamai

NOTE

怎么选
本机多工具装同一套 Skill → skills.sh;多人共享团队 AI 资产并持续同步 → TeamAI。


按用途推荐 ​

先定场景,再选 Skill。安装统一:

shell
npx skills add <仓库> [--skill <名称>]

跨类别市场与文档见 参考链接。更多未覆盖场景可逛 SkillsMP · development。

底座 / 工程工作流 ​

Skill / 仓库用途安装
find-skills技能搜索与发现npx skills add https://github.com/vercel-labs/skills --skill find-skills
skill-creator封装自己的 Skillnpx skills add https://github.com/anthropics/skills --skill skill-creator
mcp-builder连接外部工具的 MCP 构建器见 Anthropic Skills
agent-toolsAgent 常用小工具npx skills add https://github.com/toolshell/skills --skill agent-tools
using-superpowers / brainstorming工作流元能力与需求澄清npx skills add https://github.com/obra/superpowers --skill using-superpowers
Waza8 个可链式工程习惯(/think、/ui、/check、/hunt、/write、/learn、/read、/health);比 Superpowers / gstack 更轻npx skills add tw93/Waza -a claude-code codex cursor antigravity-cli -g -y
Birdview改代码前先出架构与约束地图(HTML 可打开)npx skills add Qiuner/birdview --skill birdview
Answer me with HTML复杂问题用一页 HTML 回答(图、表、时间线);亦可出 3b1b 风格讲解视频npx skills add QingYunA/answer-me-with-html
diagram-design架构 / 流程 / 时序等图(45 种),输出自包含 HTML + SVGnpx skills add cathrynlavery/diagram-design
Matt Pocock / skills工程交付(grill-with-docs、to-prd、to-issues、tdd、diagnose)npx skills add mattpocock/skills
HumanLayer Skills工程可视化与控制环(show-me、visual-pr、design-control-loop 等)npx skills add humanlayer/skills --skill show-me

合集仓库(一次装一批,再按需选 skill):

仓库说明
Anthropic Skills官方实现,含 skill-creator / mcp-builder
Vercel Skills含 find-skills 等示例
MiniMax Skills官方开发技能库(Beta)
Antfu Skills高质量个人工程实践
Claude Code Stock Deep Research Agent实战案例

调研 / 互联网 ​

Skill用途安装
Agent Reach读网能力层:网页 / YouTube 字幕 / GitHub / RSS / B 站 / 语义搜索等;部分平台需登录态。选型 + 安装 + 体检,读取走上游工具;agent-reach doctor 看当前后端复制给 Agent:帮我安装 Agent Reach:https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md(不要从 PyPI 装同名包)
ego-browser经 ego(lite) 在隔离 Space 打开页面、读 Snapshot、驱动浏览器;可继承 Chrome 登录态;接 Claude Code / Codex / Cursor 等先装 ego(lite),或 npx skills add citrolabs/ego-lite;用法见 Skills 文档

NOTE

边界
Agent Reach 负责从网上取内容(读、搜、字幕),不负责写报告 / 发帖。登录态平台用专用小号;默认 install 只体检不改系统,真正装依赖要显式 --system。
ego-browser 是真实网页交互:留意权限提示;登录、验证码、付款与最终提交由人处理。产品对比见 浏览器与桌面操控。

前端 / 设计 ​

Skill来源用途
frontend-skillOpenAIlanding / 品牌 / demo;视觉论点、内容节奏、首屏
frontend-designAnthropic高完成度、强风格;页面更有辨识度
figma-implement-designOpenAI设计稿到代码
web-design-guidelinesVercelUI 审查(a11y、表单、动效、排版、交互)
react-best-practicesVercelReact / Next.js 实现与性能
playwrightOpenAI真实浏览器验证;UI 调试与回归
webapp-testingAnthropic本地应用验证(行为、截图、日志)
canvas-designAnthropic画布式视觉探索、展示页、概念设计
brand-guidelinesAnthropic官网 / 营销 / 设计系统 / 品牌一致性
vercel-deploy-claimableVercel快速部署预览、缩短反馈闭环

社区增强(审美、动效、系统审界面):

Skill用途安装
taste-skillAnti-slop 前端审美;默认 design-taste-frontend(v2)npx skills add https://github.com/Leonxlnx/taste-skill
Impeccablefrontend-design 增强(/polish、/audit、/distill)npx skills add pbakaus/impeccable
emilkowalski / skills动效与界面品味(animate、apple-design、break-ui 等)npx skills add emilkowalski/skills
jakubkrehel / skills按维度审界面(a11y / 布局 / 文案 / 排版 / 色彩);含 PR 回归与设计落地npx skills add jakubkrehel/skills;Claude Code:/plugin marketplace add jakubkrehel/skills → /plugin install interfaces@interfaces

合集入口:OpenAI Skills、Vercel Agent Skills。

NOTE

怎么选 · 前端审美
官方偏「做出好看的页面」;要压住 AI 通用 slop(紫渐变、卡片堆砌),优先 taste-skill 或 Impeccable。动效与「该不该动」用 emilkowalski / skills。按维度系统审界面或审 PR 界面回归,用 jakubkrehel / skills。

通用办公 ​

Skill来源用途
pptxAnthropic做 / 改 / 读 PPT,按模板生成 deck
pdfAnthropic提取、合并、OCR、表单、拆分
docxAnthropic正式报告、方案、备忘录、函件
xlsxAnthropic表格、公式、格式化、图表
anydoc(Firecrawl)Firecrawl14 种办公文档 → 干净 GFM Markdown(本地毫秒级);npx @firecrawl/anydoc
transcribeOpenAI会议录音、访谈转文字
internal-commsAnthropic周报、项目更新、公告
doc-coauthoringAnthropic协作写作,整理成正式文档
notion-knowledge-captureOpenAI会议与决策沉淀进 Notion
screenshotOpenAI截图留痕、操作说明
theme-factoryAnthropic统一文档 / 演示视觉主题

NOTE

边界
官方 pptx / docx / pdf 偏「读写与精修办公文档」。本地文档转成给 Agent 读的 Markdown → anydoc。浏览器里快速出完整 deck、改字换图再导出 PPTX → dashi-ppt-skill;本地桌面端完整工作流(导入 PPTX / 风格库 / 对话改页 / 导出)→ oh-my-ppt。详见 PPT / 演示文稿。

公众号 / 内容创作 ​

Skill用途安装
gzh-design-skillMarkdown → 可粘贴进公众号编辑器的 HTML(6 套主题 + 主题生成器)npx skills add https://github.com/isjiamu/gzh-design-skill
Humanizer-zh中文润色:去空话、套话与 AI 痕迹,保留事实与作者声音npx skills add https://github.com/op7418/Humanizer-zh.git
baoyu-skills文配图 / 插画生成见仓库说明

PPT / 演示文稿 ​

Skill用途安装 / 入口
oh-my-ppt本地优先桌面端:描述主题 → AI 生成可编辑 HTML 幻灯片;导入/导出可编辑 PPTX、90+ 风格、对话改页、生图配图(自配模型 / 可接 Ollama)官网 / Releases
dashi-ppt-skill网页可编辑 PPT → 导出 HTML / PDF / 可编辑 PPTX(12 主题、1020 版式;需 Node 20+;导出需本机 Chrome / Chromium / Edge)npx dashi-ppt-skill@latest
pptx按模板读写 / 精修现有 PPTAnthropic Skills
theme-factory统一演示视觉主题同上

视频制作 ​

Skill用途安装
jacky-motion口播稿 + SRT → 可录屏的 16:9 自动播放 HTML(不直接出 MP4)npx skills add https://github.com/Jackywxsz/jacky-motion
OpenMontageAgent 全流程视频制片(pipeline + 700+ 技能/知识文件;需 Python 3.10+、FFmpeg、Node 18+)git clone + make setup

参考链接 ​

只放跨类别资源(文档、安装工具、市场、Awesome)。按用途的推荐见上一节,此处不重复。

文档与规范 ​

安装与管理 ​

市场与合集 ​

Awesome / 索引 ​

NOTE

延伸阅读
推荐技能、资讯与实战案例的专题汇总:
Agent Skills 终极指南

发现问题或有实践经验想分享? 参与讨论 ↗

把 AI 从「会聊天」推进到「能稳定交付」