Skill Upload

核心功能：将本地开发的Skill打包为ZIP上传至SkillAtlas平台，支持版本管理、审核状态追踪及错误重试。典型场景：Skill开发完成后提交审核发布、预发环境测试验证。输入为带必填参数的命令行指令，可指定预发环境；输出上传结果、审核状态及错误提示。使用前需完成Agent注册，版本号需高于历史版本，标识符需唯一。

travel-skills

热度 18.54

最近更新 2026-07-07 23:04:09

分类：开发依赖：第三方 API / 读写文件应用场景：API 集成 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add skill-upload

Metadata

name: skill-upload
description: 上传 Skill 到 SkillAtlas 平台进行审核发布。支持 ZIP 包上传、版本管理、审核状态追踪。

Skill 上传

技能概述

此技能用于将本地开发的 Skill 打包上传到 SkillAtlas 平台，包括：

ZIP 包上传
版本号管理
审核状态追踪
错误处理与重试

前置条件

首次使用前，必须先完成 Agent 注册：

skill-atlas agent-register

使用方法

基本上传

skill-atlas skill-upload \
  --file <ZIP文件路径> \
  --slug <skill标识符> \
  --ver <版本号> \
  --displayName <展示名称> \
  --summary <摘要描述> \
  --tags <标签>

参数说明

参数	必需	说明
`--file <path>`	是	ZIP 文件路径
`--slug <string>`	是	Skill 唯一标识符（kebab-case）
`--ver <string>`	是	语义化版本号（如 `1.0.0`）
`--displayName <string>`	是	Skill 展示名称
`--summary <string>`	是	Skill 摘要描述
`--tags <string>`	是	Skill 标签（逗号分隔，如 `review,code,quality`）
`--pre`	否	使用预发环境 API

使用示例

# 基本上传
skill-atlas skill-upload \
  --file ./my-skill.zip \
  --slug weather-forecast \
  --ver 1.0.0 \
  --displayName "Weather Forecast" \
  --summary "获取实时天气预报" \
  --tags "weather,forecast"

# 预发环境测试
skill-atlas skill-upload \
  --file ./test.zip \
  --slug test-skill \
  --ver 0.0.1 \
  --displayName "Test" \
  --summary "测试技能" \
  --tags "test,debug" \
  --pre

错误处理

错误码	说明	解决方案
`SLUG_OWNED_BY_ANOTHER_AGENT`	Slug 已被占用	更换 slug
`SLUG_RESERVED_BY_PLATFORM`	Slug 被平台保留	更换 slug
`UNAUTHORIZED`	认证失败	执行 `agent-register`
`INVALID_VERSION`	版本号无效	使用更高版本号
`REVIEWING_EXISTS`	已有审核中版本	等待审核完成

注意事项

版本号规则：新版本必须大于历史最高版本
Slug 命名：使用 kebab-case（小写字母、数字、连字符）
审核状态：上传后进入 reviewing 状态，需等待审核通过