使用指南

从制作到使用,轻松上手团队 Skills3个章节

制作自己的 Skill → 按 FunSkill 规范打包 → 上传网站,检测通过后发布给团队使用。

文档导航
01 / 制作与发布

如何制作自己的 Skill

沿用 FunSkill 打包助手的九项模板。每项写清必要信息即可,不要求长篇说明;不适用项说明原因,未实测如实注明。

先选一个值得复用的任务

优先选择反复出现、步骤相对稳定、结果可以验收的工作。把已有项目中的有效方法整理出来,再让另一位同事用不同输入试一次,根据反馈修订。

Skill 的核心是 SKILL.md:向 Agent 说明何时使用、怎么执行、如何验收。长篇规范、示例和脚本放进独立文件,在正文中写明何时读取。

从制作到发布,三步完成

从零制作或更新已有 Skill,都使用同一条制作与打包指令。

  1. 01

    安装 FunSkill 打包助手

    下载下方 ZIP,在你使用的工具中导入完整文件包;也可以把 ZIP 交给 Agent,让它按当前环境支持的方式安装。安装方法见下方“使用与安装 Skill”。

    下载 FunSkill 打包助手

    版本 1.2.0 · 。保留目标 Skill 的真实作者,不自动运行目标脚本或发布网站。

  2. 02

    制作或整理并打包

    把工作方法、输入案例或已有 Skill 文件夹交给 AI,再发送下面的统一指令。助手会补齐九项说明、生成网站信息与 Logo、校验并输出 ZIP;完成后用一个真实任务试用。

    制作与打包指令
    请使用 FunSkill 打包助手处理我提供的工作方法、案例或 Skill 文件夹:保留真实作者、原有能力和必要文件,自动推断已有信息,只把无法确定的问题一次问完,最后输出可上传的 ZIP。
  3. 03

    上传网站,检测通过后发布

    登录普通账号,进入发布页,将 ZIP 拖入上传区。网站自动检测并读取名称、作者、分类、版本、完整说明和 Logo;核对信息后在页面底部点击“确认发布”。无需管理员审批。

    检测不通过时,点击“复制修复指令”交给 AI,修复后重新选择 ZIP。规范检查不代表实际运行效果已经验证,发布前仍需试用。

    前往上传 Skill
版本更新

后续如何更新?

修改原 Skill 后再次调用打包助手,保持英文标识不变并递增版本号。上传新 ZIP,网站自动识别已有条目;检测通过后确认更新。历史版本保留,仅发布者本人或管理员可更新,重复版本不能发布。

02 / 使用与安装

如何使用和安装 Skill

先确认适用场景,再安装完整文件包,最后用一个小任务验证结果。

  1. 01

    选择适合当前任务的 Skill

    阅读概述、输入要求和输出案例,确认使用环境具备需要的图像工具、软件或依赖。先看“常见失败”,判断限制是否可接受。

  2. 02

    下载并复制安装指令

    在详情页点击同名按钮,网站会下载完整 Skill 包并复制安装指令。ZIP 会保留 SKILL.md、参考文件和脚本的目录结构;如果只有 SKILL.md,先确认任务是否还需要其他附件。

  3. 03

    交给 Agent 安装

    把刚下载的文件包交给 Agent,粘贴已复制的指令;Agent 会先检查当前环境,再按支持的方式安装完整文件夹。

    没有安装能力时,可在当前对话附上 SKILL.md 及必要参考文件,让 Agent 按流程执行。这种用法通常只对当前对话生效,不代表已经全局安装。

  4. 04

    提供输入,明确调用

    发送“请使用「活动页拆图 Skill」,处理这张主题风格稿,输出透明 WebP 集合图”,并附上需要的文件、尺寸和约束。执行涉及外部账号、付费或修改源文件的步骤前,先确认具体操作。

  5. 05

    检查结果,反馈并更新

    按 Skill 的验收清单检查产物。遇到问题,在评论区说明使用版本、输入类型、实际结果和预期结果,可附图帮助作者复现。更新时先保留旧版本,再重新安装和试用。

通用安装与试用提示词

把完整 ZIP 与提示词一起交给 Agent,让它先检查环境和缺失文件。

安装提示词
我已附上这个 Skill 的完整 ZIP 文件包。
请先阅读 SKILL.md,检查引用文件、所需工具和依赖是否齐全。
如果当前环境支持 Skill 安装,请按该环境的规范安装完整文件夹,保留目录结构;安装时不要运行其中的脚本。
如果不支持安装,请直接读取 SKILL.md 及本次任务需要的参考文件,告诉我哪些功能受限。
最后告诉我如何调用,并用提供的示例输入完成一次试用。

常见问题

先核对文件、环境和输入,再判断是否需要联系作者。

安装后没有生效?

确认 Skill 已启用、文件夹层级正确、SKILL.md 能读取。按工具要求重新载入或新建对话,并明确点名调用。仍不可用时,请 Agent 检查缺失依赖和当前环境支持情况。

输出与示例不一致?

检查输入是否完整、约束是否清楚,以及工具或模型版本是否不同。Skill 提供执行方法,结果仍需按验收标准检查;将具体差异带回评论区交流。

查看活动页拆图示范
03 / 规范与检查

规范与检查

统一模板与视觉规范,发布前对照检查。

九项内容规范

把任务边界、执行步骤和验收方式写清楚,方便同事直接复用。

  1. 01

    解决什么问题

    从真实工作出发,说明任务、痛点和目标,避免只写“提高效率”。

    示例活动页拆图:把完整主题稿中的可复用 UI 整理为素材集合图。
  2. 02

    适用与不适用场景

    写清适用任务、必要工具以及不能保证的结果。

    示例适合重绘按钮、边框和图标;不能恢复源设计文件或被遮挡的原始像素。
  3. 03

    需要准备什么输入

    区分必需与可选资料,说明尺寸、格式与约束,缺失时先询问。

    示例完整主题风格稿、目标尺寸、保留元素、透明背景要求。
  4. 04

    三分钟快速开始

    给出最短上手路径和一条可以直接复制的调用语句。

    示例安装 Skill → 附上主题稿 → 明确输出集合图与透明要求。
  5. 05

    完整操作步骤

    写清先后顺序、工具、检查点、确认节点和异常处理。

    示例盘点元素 → 去重 → 重绘 → 去文字 → 检查透明区域 → 整理交付。
  6. 06

    输出示例和可下载文件

    展示输入与输出对照,列出交付格式、命名、尺寸和验收标准。

    示例提供主题稿与集合图案例;完整 ZIP 包含 SKILL.md 和实际引用的素材。
  7. 07

    常见失败及处理方式

    写出失败现象、原因、修正方式和需要人工复核的部分。

    示例框中心仍有底板:去掉内容区底板,保留装饰边框与实心空白名牌。
  8. 08

    作者、协作者和维护人

    保留贡献者署名,同时明确谁负责后续维护。

    示例作者:庞伟深;协作者按实际填写;维护人应有明确归属。
  9. 09

    版本、更新时间、最后验证时间

    记录实际变更和最近一次试用时间,注明测试环境,不编造验证结果。

    示例版本 1.0.0;日期按实际填写;未试用时写“尚未验证”。

上传与评分规范

依据 FunSkill 打包助手 v1.2.0;上传与评测共用九项内容检测。

  • 标准 ZIP 根目录包含 SKILL.md、funskill.json 和 skill-logo.webp;名称、简介、真实作者、分类、英文标识和版本完整。
  • SKILL.md 包含 name、description 以及九项实际说明;空章节、单独的 TODO 等占位内容不通过。短说明和有原因的不适用项可以通过。
  • ZIP 最多 10 MB、200 个文件;单文件最多 20 MB,解压总量最多 30 MB;SKILL.md 最多 150 KB、详情最多 40000 字,funskill.json 最多 16 KB。不得包含凭据文件或越界路径。
  • 普通 SKILL.md 与旧版 ZIP 仍可上传;更新沿用英文标识并使用未发布过的版本号,未携带新 Logo 时保留原 Logo。

规则评分 = 5 × 通过项 ÷ 自动检测项。未通过和需复核计入分母,待实测不计入。除九项说明,还检查入口、元数据、文件包、引用与风险模式。评分不代表功能效果或安全认证,上传通过也不保证满分。

统一 SKILL.md 模板

复制后替换占位内容,保存为 UTF-8 编码的 SKILL.md。

SKILL.md
展开完整模板
---
name: your-skill-name
description: 说明这个 Skill 做什么,以及用户提出什么任务时应该使用。
---

# Skill 名称

## 1. 解决什么问题
描述真实任务、重复工作和预期改善。一个 Skill 优先解决一个明确问题。

## 2. 适用与不适用场景
适用:……
不适用:……
依赖工具或环境:……

## 3. 需要准备什么输入
必需:参考图、文件、尺寸、目标等。
可选:风格、语言、格式、特殊约束。
缺少输入时:先询问哪些关键问题。

## 4. 三分钟快速开始
1. 安装此 Skill 并准备示例输入。
2. 发送:「请使用 [Skill 名称],基于 [输入] 完成 [任务],输出 [交付物]。」
3. 按下方验收标准检查结果。

## 5. 完整操作步骤
1. 检查输入与约束。
2. 执行核心流程,写清顺序、工具、参数和必要的确认节点。
3. 检查质量;不合格时说明修正方法。
4. 按约定格式交付,并列出需要人工复核的内容。

## 6. 输出示例和可下载文件
输入示例:examples/input 文件或说明。
输出示例:examples/output 文件或说明。
交付清单:文件名、格式、尺寸、目录结构。
验收标准:列出可观察、可检查的具体条件。
下载内容:完整 Skill ZIP,包含实际引用的文件。

## 7. 常见失败及处理方式
现象:……
原因:……
处理:……
无法自动完成时:明确说明边界与人工处理方式。

## 8. 作者、协作者和维护人
作者:……
协作者:……(没有则填「无」)
维护人:……

## 9. 版本、更新时间、最后验证时间
版本:1.0.0
更新时间:YYYY-MM-DD
最后验证时间:YYYY-MM-DD(未验证则如实填写「尚未验证」)
验证记录:使用的工具、模型或软件版本,测试输入与结果。
更新说明:本次变更及已知限制。

建议的文件结构

只打包实际需要的文件,并保持引用路径清楚、有效。

your-skill-name/
├── SKILL.md          # 核心规则,必需
├── funskill.json     # 打包助手生成的网站信息
├── skill-logo.webp   # 192×192 配套 Logo
├── references/      # 详细规范,按需提供
├── examples/        # 输入和输出案例
└── scripts/         # 自动化脚本,按需提供

网站展示图片统一压缩为 WebP;下载包中的原始素材保留所需格式。

发布前检查

按最新版打包规范检查;建议真实试用,但未实测可如实注明。

  • 九项说明齐全,操作步骤可以复现。
  • 示例与文件真实存在,下载包无缺失引用。
  • skill-logo.webp 符合尺寸、格式、体积和视觉规范。
  • 已试用则记录实际结果与时间,未试用填写“尚未验证”。
  • 保留作者署名,确定后续维护人。