mcpField
M
meta-skill-creator

meta-skill-creator

github.com/oakossAgent 工作流20107 次安装10 周前更新
代码仓库

关于 meta-skill-creator

用于创建和验证 Agent Skills 的技能，面向编写可移植技能的开发者。它涵盖目录结构、元数据、内容组织、分发限制和验证流程，并提供常见错误检查要点。

主要功能

  1. 01规划技能目录与文件结构
  2. 02编写必需及可选 frontmatter
  3. 03按渐进披露组织技能内容
  4. 04检查常见结构与命名错误
  5. 05使用验证器检查技能

适用场景

  1. 01从零创建符合规范的技能
  2. 02将冗长指令拆分为参考文件
  3. 03分发前验证技能结构

安装

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

$npx skills add https://github.com/oakoss/agent-skills --skill meta-skill-creator

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

包含的文件

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

references/
frontmatter.md
skill-anatomy.md
validation.md
scripts/
validate-component.py
validate-skill.py

详细介绍

Meta Skill Creator

概述

Agent Skills 是可移植的文件夹，包含指令、脚本和资源，供 Agent 发现并按需加载。它们遵循 Agent Skills 开放标准，可在 27 款以上兼容的 Agent 中使用，包括 Claude Code、Cursor、Gemini CLI、OpenAI Codex、VS Code、GitHub Copilot、Windsurf、Goose 和 Roo Code。本技能涵盖创建、构建和验证技能的完整工作流。

快速参考

概念摘要关键规则
目录结构skill-name/SKILL.md，以及可选的 references/、scripts/、assets/SKILL.md 是唯一必需文件
前置元数据（必需）包含 name 和 description 的 YAML 块name 必须与目录名一致，最多 64 个字符
前置元数据（可选）license、compatibility、metadata、allowed-tools由开放标准定义，可在各 Agent 间移植
Agent 专属字段model、context、agent、hooks、user-invocableClaude Code 扩展，不可移植
描述触发语包含“Use when...”或“Use for...”短语富含关键词，使用第三人称语气
渐进式披露元数据 -> 指令 -> 资源（三级）完整加载 SKILL.md；按需加载 references
SKILL.md 长度目标为 100-150 行，最多 500 行SKILL.md 中不包含代码示例
SKILL.md 章节概述、快速参考、常见错误、委派、参考资料五个章节均为必需
参考文件带有前置元数据的 references/[topic].md每个文件最多 500 行，且内容自成一体
参考文件前置元数据title、description、tags 字段所有参考文件都必须包含
脚本scripts/ 目录，可执行代码Agent 运行脚本，而非读取源码
名称格式小写字母、数字、连字符不得包含 --，不得以 - 开头或结尾，至少 4 个字符
排除的文件名README.md、metadata.json、_* 文件不会由分发 CLI 安装
验证skills-ref validate 或项目专用验证器分发前始终进行验证

技能创建工作流

  1. 创建目录：在适当位置创建目录，并添加 SKILL.md
  2. 编写前置元数据：填写与目录名一致的 name，以及包含丰富触发语的 description
  3. 编写必需章节：概述、快速参考、常见错误、委派、参考资料
  4. 提取代码示例：移至 references/ 文件（SKILL.md 中不写代码）
  5. 验证：使用项目验证器或 skills-ref validate

常见错误

错误正确做法
缺少“何时使用”或“适用于”触发语在描述中加入触发短语，便于 Agent 发现
在 SKILL.md 中编写代码示例将所有代码移至 references/ 文件
SKILL.md 超过 500 行将详细内容拆分到参考文件中
参考文件相互交叉引用让参考内容自成一体，并确保从 SKILL.md 出发最多一层
名称与目录不匹配name 字段必须与父目录名称完全一致
名称包含大写字母或空格仅使用小写字母、数字和连字符
描述含糊且缺少关键词在触发语中加入同义词、缩写和库名称
代码块未指定语言始终为围栏代码块指定语言
SKILL.md 未链接支持文件Agent 通过 SKILL.md 中的明确链接发现文件
使用了排除的文件名避免使用 README.md、metadata.json 以及以下划线开头的文件
frontmatter 前有空行--- 必须位于第 1 行，前面不能有空行
描述使用第一人称使用第三人称：“提取文本”，而非“我可以帮你”
参考链嵌套过深保持一层深度：SKILL.md 直接链接到 references
缺少必需的 SKILL.md 章节包含全部五个章节：概述、快速参考、错误、委派、参考资料
参考文件缺少 frontmatter每个参考文件都需要 title、description 和 tags

Skill 位置

根据可见性需求，Skill 可以安装在不同的作用范围：

位置路径作用范围
个人~/.claude/skills/你自己的所有项目
项目.claude/skills/仓库中的所有人
分发通过 skills CLI插件用户

委派

  • 规范问题：参阅 Agent Skills 开放标准
  • 模式发现：使用 Explore Agent 分析现有 Skill，了解结构示例
  • 验证：提交前运行项目验证器或 skills-ref validate

参考资料

评论

支持 Markdown