📖 2026 年 AI Agent Skills 使用指南：SKILL.md 完全教程

AI 代理技能正在彻底改变我们与 AI 编码助手交互的方式。与其每次都需要详细提示，skills 允许你将专业知识、工作流和最佳实践打包成可重用的模块，任何兼容的 AI 代理都可以加载。

本指南将带你了解如何使用 AI agent skills，涵盖从基础到高级主题的所有内容。

🤖 什么是 AI Agent Skills？

AI Agent Skills 是包含指令、脚本和资源的模块化包，赋予 AI 代理特定领域的专业知识。每个技能都位于自己的目录中，包含一个必需的 SKILL.md 文件。

SKILL.md 文件包含：

• YAML frontmatter 元数据（名称、描述、配置）
• Markdown 指令，代理在技能激活时遵循
• 可选的脚本、参考文档和资源

💡 核心概念

Skills 使用渐进式披露架构：

1. 启动时：只加载技能名称和描述
2. 激活时：加载完整的 SKILL.md 内容
3. 按需：加载额外资源和脚本

这意味着你可以安装数百个技能而不会影响性能。

📁 Skills 的存储位置

🔧 如何安装 Skills

安装 skills 非常简单。使用 skills.sh 注册表提供的 npx 命令：

npx skillsadd owner/repo

例如：

npx skillsadd vercel-labs/agent-skills

📝 SKILL.md 格式详解

YAML Frontmatter

---
name: my-skill-name
description: "清晰描述技能的作用和何时使用"
license: MIT
compatibility:
  - claude-code
  - cursor
metadata:
  author: your-name
  version: 1.0.0
---

# 技能内容

## 何时激活
说明技能应该在什么情况下激活

## 执行步骤
1. 第一步
2. 第二步
3. 第三步

最佳实践

• 描述要具体：清楚说明触发条件和输出格式
• 保持专注：每个技能应该做好一件事
• 使用示例：包含好坏示例帮助代理理解
• 测试迭代：在真实场景中测试并改进

🏆 热门 Skills 推荐

1. Superpowers

强制执行”先计划后编码”方法论，包含 TDD 工作流和系统化调试。

npx skillsadd obra/superpowers

2. Vercel React 最佳实践

Vercel 官方的 React 和 Next.js 性能优化模式。

npx skillsadd vercel-labs/agent-skills

3. Web 设计指南

生成一致、专业的 UI，包含排版、颜色和可访问性标准。

4. 文档技能

生成 PDF、Word、PPT 和 Excel 文档的生产级实现。

5. Playwright 测试

自动化浏览器测试，带视觉截图验证。

🛠️ 创建自定义 Skills

步骤 1：创建目录

mkdir -p .claude/skills/my-skill

步骤 2：编写 SKILL.md

---
name: my-skill
description: "描述技能的作用"
---

# 我的技能

## 何时使用
当用户要求 X 时激活

## 如何执行
1. 执行步骤一
2. 执行步骤二

步骤 3：添加可选资源

mkdir -p .claude/skills/my-skill/scripts
mkdir -p .claude/skills/my-skill/references

🌐 支持的工具

AI Agent Skills 是开放标准，已被 16+ 主流工具采用：

• Claude Code (Anthropic)
• Cursor (Anysphere)
• OpenAI Codex
• Gemini CLI (Google)
• GitHub Copilot
• VS Code
• JetBrains Junie
• OpenHands
• 以及更多…

📚 Skills 注册表

skills.sh：主要注册表，57,000+ 索引技能

GitHub – anthropics/skills：官方参考实现

skillhub.club：AI 评估和评分技能

⚠️ 安全考虑

Skills 可以包含可执行脚本，因此需要注意安全：

• 安装前阅读每个 SKILL.md
• 审计 scripts/ 中的所有文件
• 使用 allowed-tools 限制权限
• 优先选择知名发布者的技能
• 固定版本，不要自动更新

💡 总结

AI Agent Skills 代表了与 AI 编码助手交互方式的根本转变。通过安装或创建 skills，你可以将通用代理转变为了解你的框架、遵循你的约定并自动应用最佳实践的专业代理。

从几个与你的工作流匹配的技能开始，然后逐渐创建你自己的定制技能。一旦你体验到训练有素的代理和通用代理之间的差异，你就再也回不去了。

YUANLEISVIP

收藏 链接