skillhub 发布助手
把"上传 skill 到 skillhub"标准化:自动读源 skill → 产出发布文案 + 填表清单。
一、何时使用
- 用户要把某个本地 skill 发布 / 上传到 skillhub。
- 用户需要某 skill 的发布文案 + 发布界面各字段的填写内容。
二、前置:确认目标 skill
- 询问或确认要发布哪个 skill(目录名或路径)。
- 读取其
SKILL.md:取name(显示名称)、description(卖点 + 触发词)、正文(核心能力 / 工作流 / 迭代记录)。 - 扫一眼目录结构(scripts / references / demo),用于文案的"安装与依赖"段。
- 检查是否已有 zip 包;若没有,用下方命令打包(顶层文件夹名 = skill 目录名)。
打包命令(Python,保留顶层 skill 目录):
import os, zipfile
src = r"<skill目录绝对路径>"
out = r"<工作区>/<skill名>.zip"
root = os.path.basename(src.rstrip("/\\"))
with zipfile.ZipFile(out, "w", zipfile.ZIP_DEFLATED) as z:
for dp, dns, fns in os.walk(src):
for fn in fns:
fp = os.path.join(dp, fn)
b = os.path.basename(fp)
if b in {".DS_Store", "Thumbs.db"} or b.endswith(".pyc"):
continue
z.write(fp, os.path.join(root, os.path.relpath(fp, src)))
三、产出物 1:发布文案
基于 references/发布文案模板.md 生成 <skill名>_发布文案.md 到当前工作区。必含板块:标题 + 标签 + 一句话简介、解决的问题、核心能力、适用 / 不适用、输入要求、输出物、与同类差异、安装依赖、触发词、版本。
四、产出物 2:填表清单
基于 references/填表清单模板.md 生成 <skill名>_填表清单.md,字段直接对应 skillhub 发布界面:
- Skill 文件:<skill名>.zip 路径
- Slug *:小写字母 / 数字 / 连字符,仅 [a-z0-9-];建议从 name 派生(中文名译英或拼音,无空格)。发布后通常不可改,选稳定值
- 显示名称 *:SKILL.md 的 name 原值
- 图标:建议选预设图标(流程 / 文档 / HR 等风格),或自定义上传
- 描述:可直接粘贴的精简版(卖点 + 适用 + 核心能力 + 触发词 + 关键词),弥补无标签字段
- 版本号 *:1.0.0(首版)
- 变更说明:首版写"初始发布" + 迭代摘要;更新版写本次变更
- 标签变通:界面无独立标签字段 → 在描述末尾加「关键词 / 标签」段,搜录会索引描述全文
五、交付
用 present_files 同时给出:发布文案 .md、填表清单 .md,以及 zip(若新生成)。
六、注意事项
- Slug 不含中文或空格,发布后慎改。
- 描述里务必嵌入触发词与关键词,替代缺失的标签字段。
- 若源 skill 的
description过长,填表清单的"描述"段可适度精简,但须保留触发词清单。 - 打包前确认
_user_meta.json等元数据是否需要清理(如installedAt/source字段,部分平台要求纯净包可去掉)。