skills学习

2026-06-11

记录skills学习笔记，写的原因是因为不写印象记不住，仅此而已。

介绍

skills我的理解是给agent装一份技能包，收束和规范agent的行为，来指引agent的工作，有点像是把原先代码里的if else改了一份出来给agent来看。但是我感觉这可能会限制agent的能力？

加载方式

Discovery：Agent启动时,只加载name和description基础信息
Activation：当agent的工作内容和skills匹配时，读取完整的skills.md
Execution：agent按照skills的指示来进行工作。

基本格式

my-skill/
├── SKILL.md          # Required: metadata + instructions
├── scripts/          # Optional: executable code
├── references/       # Optional: documentation
├── assets/           # Optional: templates, resources
└── ...               # Any additional files or directories

SKILL.md

SKILL.md用于记录skills的基础信息，分为Frontmatter和body content

Frontmatter

Frontmatter是yaml格式的配置文件，必填name和description字段，可选license、compatibility、metadata和allowed-tools

name：skills的名字
description: skills的功能描述
license：本skill适用的license或license文件路径
compatibility：skills运行所需要的环境，比如网络环境等
metadata：key-value格式的元数据，记录author、version等
allowed-tools：运行使用的工具

示例：

---
name: pdf-processing
description: Extract PDF text, fill forms, merge files. Use when handling PDFs.
license: Apache-2.0
metadata:
  author: example-org
  version: "1.0"
---

Body

没有固定格式，能说清如何指引skills工作即可，官方推荐：
（1）逐步骤的指引
（2）给出输入输出的示例
（3）给出边界case

scripts

放可执行代码的地方，供agent运行调用

references/

放参考文档的地方，以文档为主

assets/

放模版的地方，比如参考文档模版 or 配置模板

附录

其他比如优化描述等可以详细看：https://agentskills.io/home
创建skills工具包：skill-creator

本文作者： yd0ng
本文链接： https://blog.yd0ng.top/2026/06/11/skills%E5%AD%A6%E4%B9%A0/
版权声明： 本作品采用知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议进行许可。转载请注明出处！

阅读数: 次

缺失模块。
1、请确保node版本大于6.2
2、在博客根目录（注意不是yilia根目录）执行以下命令：
npm i hexo-generator-json-content --save

3、在根目录_config.yml里添加配置：

  jsonContent:
    meta: false
    pages: false
    posts:
      title: true
      date: true
      path: true
      text: false
      raw: false
      content: false
      slug: false
      updated: false
      comments: false
      link: false
      permalink: false
      excerpt: false
      categories: false
      tags: true

网络安全<br>敬畏技术<br>保持正直