Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Design & UI

skill-creator

创建或更新 Agent 技能。用于设计、构建或打包技能,包括脚本、参考资料和资源文件。

xt765 · AI review on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add xt765/FinchBot --skill skill-creator

About this skill


name: skill-creator description: 创建或更新 Agent 技能。用于设计、构建或打包技能,包括脚本、参考资料和资源文件。 metadata: {"finchbot":{"emoji":"🛠️","always":false}}

技能创建指南

本技能提供创建有效 Agent 技能的指导。

关于技能

技能是模块化、自包含的包,通过提供专业知识、工作流程和工具来扩展 Agent 的能力。可以把它们看作特定领域或任务的"入门指南"。

技能提供的功能

  1. 专业工作流程 - 特定领域的多步骤流程
  2. 工具集成 - 处理特定文件格式或 API 的说明
  3. 领域专业知识 - 公司特定知识、模式、业务逻辑
  4. 打包资源 - 用于复杂和重复任务的脚本、参考资料和资源文件

核心原则

简洁是关键

上下文窗口是公共资源。技能与 Agent 需要的所有其他内容共享上下文窗口。

默认假设:Agent 已经非常聪明。 只添加 Agent 尚未拥有的上下文。

优先使用简洁的示例而不是冗长的解释。

技能的结构

每个技能由必需的 SKILL.md 文件和可选的打包资源组成:

skill-name/
├── SKILL.md (必需)
│   ├── YAML frontmatter 元数据 (必需)
│   │   ├── name: (必需)
│   │   └── description: (必需)
│   └── Markdown 使用说明 (必需)
└── 打包资源 (可选)
    ├── scripts/          - 可执行代码 (Python/Bash 等)
    ├── references/       - 文档,按需加载到上下文
    └── assets/           - 输出中使用的文件 (模板、图标、字体等)

SKILL.md (必需)

每个 SKILL.md 包含:

  • Frontmatter (YAML):包含 name 和 description 字段
  • 正文 (Markdown):使用技能的说明和指南

技能 Frontmatter 示例

---
name: weather
description: 查询当前天气和天气预报(无需 API 密钥)。
homepage: https://wttr.in/:help
metadata: {"finchbot":{"emoji":"🌤️","requires":{"bins":["curl"]}}}
---

如何创建技能

  1. 创建技能目录:skills/{skill-name}/
  2. 创建 SKILL.md:添加 frontmatter 和说明
  3. 添加可选资源:根据需要添加 scripts/、references/、assets/
  4. 测试技能:验证它能正常工作

技能命名

  • 仅使用小写字母、数字和连字符
  • 优先使用简短的、以动词开头的短语来描述动作
  • 技能文件夹名称与技能名称完全一致

快速入门模板

这是一个最小化的 SKILL.md 模板:

---
name: my-skill
description: 简短描述这个技能的功能和使用时机。
metadata: {"finchbot":{"emoji":"✨"}}
---

# 我的技能

关于如何使用这个技能的简要说明。