mcpField
S
skill-creator

skill-creator

github.com/cylixleeAgent 工作流036 次安装17 周前更新
代码仓库

关于 skill-creator

skill-creator 是用于构建符合 Agent Skills 规范的可复用技能的 Agent 技能，涵盖从明确用途、组织目录到编写说明和验证的流程。

主要功能

  1. 01指导定义技能用途与触发条件
  2. 02说明目录和 frontmatter 要求
  3. 03提供指令编写步骤
  4. 04介绍可选脚本与参考资源
  5. 05支持使用 skills-ref 验证

适用场景

  1. 01为某项能力创建可复用技能
  2. 02将知识或工作流封装供 Agent 使用
  3. 03检查技能是否符合规范

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/cylixlee/skills --skill skill-creator

安装后在 Claude Code 中输入/skill-creator确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
content.md
frontmatter.md
spec.md
references/examples/
comparison.md
overview.md
simple.md
with-resources.md
with-scripts.md
references/scripts/
bun.md
deno.md
overview.md
python.md
tool-runner.md

详细介绍

技能创建器

此技能将指导你创建符合 Agent Skills 规范的新 Agent 技能。每当你需要为某项能力创建新技能时，请遵循以下说明。

何时使用此技能

  • 用户要求创建新技能
  • 用户要求为特定能力添加技能
  • 用户想要定义或构建技能
  • 用户需要将知识或工作流打包为可复用的技能

Agent Skills 核心概念

技能是可移植、带有自我说明文档的包，可扩展 AI Agent 的能力。每个技能都是一个包含 SKILL.md 文件的目录，其中存放相关说明。

如需查看完整规范，请参阅 references/spec.md。

渐进式披露架构

技能采用三级加载策略，以高效管理上下文：

层级加载内容时机Token 开销
目录name + description会话开始时~50-100 个 token
说明完整的 SKILL.md 正文激活技能时建议少于 5000 个 token
资源脚本、参考资料、素材引用时不定

创建新技能

按照以下六个步骤创建技能：

步骤 1：确定技能用途

创建文件前，请明确以下事项：

  • 此技能提供什么能力？
  • Agent 应在何时使用此技能？
  • 哪些关键词会触发此技能？
步骤 2：创建目录结构
skill-name/
├── SKILL.md          # Required
├── scripts/          # Optional: executable code
├── references/       # Optional: documentation
└── assets/           # Optional: templates, resources

目录名称必须与技能名称一致。

步骤 3：编写 Frontmatter

SKILL.md 文件必须以包含必填字段的 YAML Frontmatter 开头。

必填字段：

  • name：技能标识符（1-64 个字符，仅限小写字母和连字符）
  • description：技能的功能以及使用时机（1-1024 个字符）

可选字段：

  • license：许可证名称或文件
  • compatibility：环境要求
  • metadata：其他键值对
  • allowed-tools：预先批准的工具（实验性）

如需查看字段规范详情，请参阅 references/frontmatter.md。

步骤 4：编写说明内容

Frontmatter 后的 Markdown 正文包含技能说明。格式不受限制，但应包括：

  • 何时使用此技能
  • 分步说明
  • 输入和输出示例
  • 常见边缘情况

如需查看写作指南，请参阅 references/content.md。

步骤 5：添加可选资源

如果技能需要脚本、参考资料或素材，请将其添加到相应的子目录中：

  • scripts/：技能说明可能会调用的可执行代码
  • references/：补充文档
  • assets/：模板、数据文件或其他资源

如需查看脚本支持详情，请参阅 references/scripts/overview.md。

步骤 6：验证

确认技能符合规范：

npx skills-ref validate ./skill-name

如需查看验证详情，请参阅 references/spec.md。

快速参考

有效的名称模式
Valid:   pdf-processing, data-analysis, code-review
Invalid: PDF-Processing (uppercase), -pdf (starts with hyphen), pdf--processing (consecutive hyphens)
良好的描述示例
description: Extracts text and tables from PDF files, fills PDF forms, and merges multiple PDFs. Use when working with PDF documents or when the user mentions PDFs, forms, or document extraction.

其他资源

评论

支持 Markdown