Agent Skill 入门指南

让 AI 助手学会新技能

Speaker · 2025

核心价值

可复用

把成熟做法沉淀成固定能力,后续场景直接复用。

自动触发

写清描述与触发词后,模型会在合适时机主动调用。

组件化

规则、模板、脚本与示例可以拆分维护、按需组合。

社区共享

团队经验不再只留在聊天里,而能被持续传播与协作。

什么是 Agent Skill?

定义

Agent Skill 是给 AI 助手准备的可复用能力包。

  • 用 Markdown 描述场景、规则与执行步骤
  • 通过描述自动匹配,而不是每次重新写长 Prompt
  • 可以封装模板、脚本、图表、文档读取等工作流
把经验写成技能,而不是留在一次次对话里。

---
name: agent-skill
description: "把经验封装成可触发能力"
---
## Triggers
- 生成周报
- 读取 OneNote

## Steps
1. 识别场景
2. 调用组件
3. 输出结果
        

Skill vs 传统方式

传统方式

  • 每次重写 Prompt
  • 需要编码 Plugin
  • 静态配置文件

Agent Skill

  • 纯 Markdown
  • 自动匹配
  • 上下文感知

Skill 文件结构

  • 前置 metadata 决定名称、触发范围与能力定位
  • Overview 说明用途,帮助助手快速选对技能
  • Workflow 约束步骤,让输出更稳定、更可复现
  • Reference 与 Checklist 保证组件复用与质量校验

---
name: html-presentation
description: "把主题与模板组装成 HTML 演示"
---
## Overview
## Workflow
## Reference Library
## Quality Checklist
        

创建流程

1

确定场景

明确 Skill 要解决的具体问题和使用场景

2

编写 SKILL.md

定义触发词、工作流工具调用与输出格式

3

测试验证

多场景触发测试优化描述与输出质量

4

发布共享

推送到 GitHub 仓库供团队或社区安装使用

Skill 生态增长

Skill 使用分布

最佳实践

让 Skill 更易触发、更好维护、更容易复用

维度 ✅ 推荐 ❌ 避免
命名 短、准、可搜索,如 weekly-report 模糊抽象,如 helper123
描述 明确场景、输入与触发词 只写“处理任务”之类空泛描述
长度 结构清晰,分节表达规则与步骤 所有要求堆成一大段长文
测试 用真实样例反复验证触发与输出 写完即发布,从不回看效果

开始创建你的 Skill

— · —