Agent Skills
返回列表
🤖

技能创作向导

AI Agent 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/vercel-labs-json-render-skill-creator。

技能介绍

要解决的问题

给 Claude 加领域能力时,很多人把整份 README、安装说明和冗长背景都塞进一个 SKILL.md,结果和其他技能、对话历史一起挤占上下文。Skill Creator 把「技能是什么、该装什么文件、上下文何时才加载」写成可执行的设计规范,而不是泛泛的提示词教程。

技能如何工作

它把技能定义为 必需 SKILL.md + 可选捆绑资源,并区分四类能力来源:

  • 工作流:多步骤、有分支的领域流程(可配合 references/workflows.md 等模式)
  • scripts/:需要确定性、反复重写同一逻辑时用可执行脚本(如 PDF 旋转)
  • references/:表结构、API、政策等按需读入的文档
  • assets/:模板、图片、前端脚手架等进产出物、不进上下文的文件

SKILL.md 的 YAML frontmatter(name + description)决定何时触发;正文只在触发后加载。设计强调 渐进式披露:元数据常驻、正文控制在 essentials(建议 <500 行)、大块细节拆到 references,并避免与正文重复。

创作流程按步骤走:用具体用例弄清边界 → 从用例反推 scripts/references/assets → init_skill.py 初始化目录 → 编写 SKILL.md 与资源 → package_skill.py 打包 → 按真实使用迭代。同时用 高 / 中 / 低自由度 匹配任务脆弱性:开放域用说明性指引,易碎操作用窄参数脚本。

适用边界

技能目录里 不要 再塞 README.md、INSTALLATION_GUIDE.md 等面向人的辅文档;只保留代理完成任务所需内容。references 宜 一层引用自 SKILL.md,深层嵌套会降低可发现性。若 reference 很长,应在文件内提供目录,并在 SKILL.md 写明何时读取、是否配合 grep 模式。

使用场景

  • 团队要新增「查 BigQuery 指标」类技能,需要把表结构放进 references 而不是每次在对话里口述
  • 重复出现「旋转 PDF / 裁剪图片」类需求,打算用 scripts 固化逻辑并只保留触发描述在 frontmatter
  • 一个技能要覆盖销售、财务多域文档,希望按域拆成 sales.md / finance.md,避免无关段落被加载
  • 准备发布技能前自检:SKILL.md 是否只留流程 essentials,详细 API 说明是否已迁出正文

适合人员

  • 维护内部 Claude 技能清单的平台工程师,需要统一目录结构与打包流程
  • 把公司 API、合规政策封装成可触发模块的安全或法务协同开发者
  • 从用户真实话术反推 `name`/`description`,避免技能误触发或从不触发的产品经理
  • 写过几版臃肿 SKILL.md、想按自由度与资源分层重做技能的 AI 应用开发者