publish-to-marketplaces

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Publish Skills to Marketplaces

将技能发布至技能市场

Guide for listing agent skills on agentskill.sh and skills.sh — the two largest skill directories.

本指南介绍如何在两大顶级技能目录agentskill.sh和skills.sh中上架Agent技能。

Platform Comparison

平台对比

	agentskill.sh	skills.sh
Scale	47,000+ skills	33,500+ skills
Backed by	Yuki Capital	Vercel Labs
Install cmd	`/learn @owner/repo`	`npx skills add owner/repo`
Submit method	Web form (Analyze & Import)	CLI telemetry on first install
Auto-sync	Yes (pulls from GitHub)	Partial (telemetry-driven cache)
Ranking	Quality score + installs	Anonymous install telemetry

	agentskill.sh	skills.sh
规模	47,000+ 个技能	33,500+ 个技能
背后支持	Yuki Capital	Vercel Labs
安装命令	`/learn @owner/repo`	`npx skills add owner/repo`
提交方式	网页表单（分析与导入）	首次安装时的CLI遥测
自动同步	是（从GitHub拉取）	部分支持（基于遥测的缓存）
排名规则	质量评分 + 安装量	匿名安装遥测数据

Prerequisites

前置条件

Before publishing, ensure:

GitHub repo is public with a valid
```
SKILL.md
```
at a discoverable path (root or
```
.cursor/skills/<name>/
```
)
SKILL.md has proper frontmatter:

yaml

---
name: your-skill-name          # lowercase, hyphens, max 64 chars
description: >-                 # English, max 1024 chars
  What it does and when to use it.
license: MIT
compatibility: Requirements and supported agents.
metadata:
  author: github-username
  version: "1.0"
  tags: tag1 tag2 tag3
---

Description is in English — both platforms have international audiences
Body content is in English — skills.sh renders the full SKILL.md as the listing page

发布前请确保：

GitHub仓库为公开状态，且在可检索路径（根目录或
```
.cursor/skills/<name>/
```
）下包含有效的
```
SKILL.md
```
文件
SKILL.md包含规范的前置元数据：

yaml

---
name: your-skill-name          # 小写、连字符分隔，最多64字符
description: >-                 # 英文，最多1024字符
  技能功能及适用场景说明。
license: MIT
compatibility: 运行要求及支持的Agent类型。
metadata:
  author: github-username
  version: "1.0"
  tags: tag1 tag2 tag3
---

描述内容为英文——两大平台均面向国际用户
正文内容为英文——skills.sh会将完整SKILL.md内容作为技能详情页展示

Step 1: Publish to agentskill.sh

步骤1：发布至agentskill.sh

First-time submission

首次提交

Navigate to
```
https://agentskill.sh/submit
```
Paste the GitHub repo URL (e.g.
```
https://github.com/owner/repo
```
)
Click Analyze & Import — wait for security scan to complete
Verify the result card shows the correct skill name and description

访问
```
https://agentskill.sh/submit
```
粘贴GitHub仓库URL（例如
```
https://github.com/owner/repo
```
）
点击分析与导入——等待安全扫描完成
确认结果卡片显示正确的技能名称与描述

Verify listing

验证上架状态

Search at

https://agentskill.sh/q/<skill-name>

and confirm:

Skill name matches
```
name
```
field in frontmatter
Description matches
```
description
```
field
Security score is displayed (aim for 100/100)

Detail page lives at:

https://agentskill.sh/@owner/skill-name

访问

https://agentskill.sh/q/<skill-name>

搜索并确认：

技能名称与SKILL.md元数据中的
```
name
```
字段一致
描述内容与SKILL.md元数据中的
```
description
```
字段一致
显示安全评分（目标为100/100）

技能详情页地址：

https://agentskill.sh/@owner/skill-name

Install command for users

用户安装命令

/learn @owner/skill-name

/learn @owner/skill-name

Step 2: Publish to skills.sh

步骤2：发布至skills.sh

First-time submission

首次提交

skills.sh has no web submission form. Listing is triggered by the first install:

bash

npx skills add owner/repo --yes

The

--yes

flag skips interactive prompts. This command:

Clones the repo
Detects all SKILL.md files
Installs to all compatible agent directories
Sends anonymous telemetry to skills.sh (registers the skill)

skills.sh无网页提交表单，首次安装操作会自动触发上架：

bash

npx skills add owner/repo --yes

--yes

参数会跳过交互提示。该命令将：

克隆目标仓库
检测所有SKILL.md文件
安装至所有兼容的Agent目录
向skills.sh发送匿名遥测数据（完成技能注册）

Verify listing

验证上架状态

Check

https://skills.sh/owner/repo/skill-name

— the page renders the full SKILL.md content.

访问

https://skills.sh/owner/repo/skill-name

——页面会渲染完整的SKILL.md内容。

Install command for users

用户安装命令

bash

npx skills add owner/repo

Or install a specific skill from a multi-skill repo:

bash

npx skills add owner/repo --skill skill-name

bash

npx skills add owner/repo

或从多技能仓库中安装指定技能：

bash

npx skills add owner/repo --skill skill-name

Step 3: Update Listings After Changes

步骤3：内容更新后的列表同步

When you modify SKILL.md and push to GitHub:

Platform	Update mechanism	Action needed
agentskill.sh	Auto-sync from GitHub	Re-submit at `/submit` for immediate refresh, or wait for auto-sync
skills.sh	Telemetry on next install	Run `npx skills add owner/repo --yes` in a temp dir to trigger

当你修改SKILL.md并推送到GitHub后：

平台	更新机制	需执行操作
agentskill.sh	从GitHub自动同步	可通过 `/submit` 页面重新提交以立即刷新，或等待自动同步
skills.sh	基于下一次安装的遥测数据	在临时目录中运行 `npx skills add owner/repo --yes` 触发更新

Quick update script

快速更新脚本

bash

undefined

bash

undefined

1. Push changes to GitHub

1. 将修改推送到GitHub

git add -A && git commit -m "update skill listing" && git push

2. Re-submit to agentskill.sh (browser)

2. 重新提交至agentskill.sh（需浏览器操作）

Navigate to https://agentskill.sh/submit → paste repo URL → Analyze & Import

访问https://agentskill.sh/submit → 粘贴仓库URL → 点击「分析与导入」

3. Trigger skills.sh refresh

3. 触发skills.sh内容刷新

TMPDIR=$(mktemp -d) cd "$TMPDIR" npx skills add owner/repo --yes rm -rf "$TMPDIR"

undefined

TMPDIR=$(mktemp -d) cd "$TMPDIR" npx skills add owner/repo --yes rm -rf "$TMPDIR"

undefined

Troubleshooting

问题排查

skills.sh shows stale content

skills.sh显示过期内容

skills.sh caches content from telemetry data. After a rename or major update:

Run a fresh install via
```
npx skills add
```
to send new telemetry
Allow 12–24 hours for the platform to aggregate and refresh
If still stale after 48h, contact the platform

skills.sh会缓存遥测数据中的内容。重命名或重大更新后：

运行
```
npx skills add
```
执行全新安装以发送新的遥测数据
等待12-24小时让平台完成数据聚合与内容刷新
若48小时后仍未更新，请联系平台支持

skills.sh shows old skill name

skills.sh显示旧技能名称

The skill name is cached from the first telemetry report. A rename requires:

Push the updated SKILL.md with the new
```
name
```
field
Run
```
npx skills add owner/repo --yes
```
to send fresh telemetry
Wait for platform cache refresh (may take 24–48h)

技能名称由首次遥测报告缓存。重命名需执行：

推送包含新
```
name
```
字段的SKILL.md更新
运行
```
npx skills add owner/repo --yes
```
发送新的遥测数据
等待平台缓存刷新（可能需要24-48小时）

agentskill.sh not showing updates

agentskill.sh未显示更新内容

Re-submit at

https://agentskill.sh/submit

with the same repo URL. This forces a fresh fetch from GitHub.

在

https://agentskill.sh/submit

页面重新提交相同仓库URL，强制从GitHub拉取最新内容。

Security score issues

安全评分问题

Socket alert: Usually minor dependency concerns — review and assess
Snyk warning: Check for known vulnerabilities in scripts
Gen Agent Trust Hub: Automated content safety check — ensure no harmful patterns

Socket预警：通常为轻微依赖问题——建议检查评估风险
Snyk警告：检查脚本中的已知漏洞
Gen Agent Trust Hub：自动化内容安全检测——确保无有害代码模式

Checklist

检查清单

Publishing Checklist:
- [ ] SKILL.md has valid YAML frontmatter (name, description)
- [ ] Description is in English, specific, includes trigger terms
- [ ] Body content is in English for international visibility
- [ ] GitHub repo is public
- [ ] Submitted to agentskill.sh via /submit
- [ ] Verified agentskill.sh listing and security score
- [ ] Triggered skills.sh listing via npx skills add
- [ ] Verified skills.sh detail page
- [ ] Updated README with install commands for both platforms

发布检查清单：
- [ ] SKILL.md包含有效的YAML元数据（name、description字段）
- [ ] 描述为英文，内容具体且包含触发关键词
- [ ] 正文为英文以覆盖国际用户
- [ ] GitHub仓库为公开状态
- [ ] 已通过/submit页面提交至agentskill.sh
- [ ] 已验证agentskill.sh的技能列表与安全评分
- [ ] 已通过npx skills add触发skills.sh上架
- [ ] 已验证skills.sh的技能详情页
- [ ] 已更新README，添加两大平台的安装命令