PPingAI品智

开放平台

上架你的 Skill

面向开发者、产品团队与场景实践者开放 Skill 上传。提交后由品智团队审核、评判,通过后收录至Skill 广场,供 Cursor、OpenClaw、Hermes Agent 等 Agent 平台一键挂载。

返回 Skill 广场

Process

上架流程

01

准备 Skill 包

按标准目录组织 SKILL.md、config.json 与可选脚本。

  • SKILL.md 含 YAML 元数据(name / description / version)
  • config.json 声明命令、权限、依赖与风险等级
  • 提供「用户怎么说」示例与接入说明

02

自测与验收

在目标 Agent 平台跑通完整链路,对照执行可靠性、安全规范与文档质量自检。

  • Cursor / OpenClaw / Hermes Agent 至少一个平台验证通过
  • 声明网络、文件、凭证等权限范围
  • 敏感操作默认 draft / 人工确认,不静默越权

03

提交审核

通过 ClawHub 发布或邮件提交,附仓库链接与演示说明。

  • ClawHub 发布(推荐,Hermes Agent 可搜索安装)
  • 邮件提交至 sipingme@gmail.com
  • 附 Git 仓库、版本号、变更说明与测试录屏

04

加入 Skill 广场

审核通过后写入Skill 广场,开放给生态用户选用。

  • Skill 广场展示名称、场景、特性标签与平台兼容
  • 详情页挂载使用文档与接入步骤
  • 后续版本更新走同一审核流程

Requirements

验收要点

结构规范

SKILL.md + config.json,命名小写连字符,description 写清触发场景。

高幂等

同一指令多次调用,执行轨迹与结果可预期、可复现。

高可信

权限声明完整;发布、删改等敏感动作需用户明确授权。

文档齐全

含示例话术、错误处理、隐私与云端处理说明(如适用)。

Structure

标准目录

your-skill/
├── SKILL.md          # 必需:元数据 + Agent 指令
├── config.json       # 必需:命令、权限、依赖
├── README.md         # 可选:人类可读说明
└── scripts/          # 可选:CLI 或工具脚本
    └── run.js

Submit

提交方式

Specification

完整规范

Skill 上架规范

面向开发者、产品团队、场景实践者开放 Skill 上架。你的 Skill 经审核通过后,会出现在 Skill 广场,并可通过 ClawHub 等渠道被 Agent 平台用户安装。

谁适合上架

角色典型场景
独立开发者把自研脚本与自动化流程,封装成可复用 Skill
产品团队将产品或 API 能力 Skill 化,接入 Agent 生态
场景实践者把真实业务中跑通的流程,封装成可复用 Skill

Skill 包结构

your-skill/
├── SKILL.md          # 必需
├── config.json       # 必需
├── README.md         # 可选
└── scripts/          # 可选
    └── run.js

SKILL.md 元数据

---
name: your-skill-name
version: 1.0.0
description: 一句话说明做什么、何时触发(Agent 靠此决定是否调用)
author: Your Name <email@example.com>
tags: [场景标签]
---

name 使用小写字母、数字与连字符;description 应包含具体动作触发词,避免空泛描述。

config.json 要点

  • commands:声明 CLI 子命令与参数说明
  • permissions:filesystem / network / subprocess 范围(如实声明,审核会核对)
  • install:风险等级、是否需用户审批
  • capabilities.sensitive:涉及凭证、发布、删改等需单独说明 mitigations

可参考已上架 Skill 的 config.json 结构(如 Web Publisher)。

验收标准

标准上架要求
高并发长任务支持异步 / 流式反馈;避免阻塞 Agent 会话
高幂等同一输入多次调用,结果一致;有 jobId / trace 可追踪
高可信权限最小化;敏感操作需用户确认;隐私与云端处理写进文档

文档必须包含

  1. 用户怎么说 — 可直接复制给 Agent 的示例话术
  2. 首次配置 — 登录、鉴权、环境变量(如有)
  3. 错误与兜底 — 常见失败原因与 Agent 应如何处理
  4. 隐私说明 — 若内容上传云端,须明确告知用户并取得同意

提交方式

方式一:ClawHub(推荐)

  1. ClawHub 发布 Skill
  2. 邮件通知品智团队(主题:Skill 上架申请),附 ClawHub 链接与简介
  3. 审核通过后同步收录至 Skill 广场

方式二:邮件直提

发送至 sipingme@gmail.com,邮件请包含:

  • Skill 名称与一句话介绍
  • Git 仓库或压缩包下载链接
  • 版本号与更新说明
  • 已验证的 Agent 平台(Cursor / OpenClaw / Hermes Agent)
  • 自测步骤或简短录屏链接

方式三:企业共建

行业定制、私有化部署或联合品牌 Skill,请通过 联系我们 预约沟通。

审核周期

  • 标准 Skill:3–5 个工作日
  • 含敏感权限或云端处理:5–10 个工作日(可能要求补充安全说明)

审核通过后,你会收到确认邮件;Skill 将出现在 Skill 广场,后续版本更新走同一流程。

参考示例