Back to Details

skillmarketplace

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Skill Market

Skill 市场

Searching & Installing Skills

搜索与安装Skill

Always use the 
search_skills
tool. Do NOT manually curl, browse GitHub, or download SKILL.md files.
search_skills
does everything automatically:
  1. Local — checks installed skills first
  2. Starchild community — searches community-skills index
  3. skills.sh — searches the global skills ecosystem (OpenClaw, Vercel, Anthropic, etc.)
  4. Auto-install — installs the best match via 
    npx skills add
    (default: 
    auto_install=true
    )
请始终使用
search_skills
工具。 请勿手动使用curl、浏览GitHub或下载SKILL.md文件。
search_skills
会自动完成所有操作：
  1. 本地 — 首先检查已安装的Skill
  2. Starchild社区 — 搜索社区Skill索引
  3. skills.sh — 搜索全球Skill生态系统（OpenClaw、Vercel、Anthropic等）
  4. 自动安装 — 通过
    npx skills add
    安装最佳匹配Skill（默认：
    auto_install=true
    ）

Usage

使用方法

search_skills(query="deploy")           # search + auto-install best match
search_skills(query="trading")          # search + auto-install
search_skills(query="k8s", auto_install=false)  # search only, don't install
search_skills()                         # list all installed skills
After 
search_skills
installs a skill, it's immediately available. Call 
skill_refresh()
only if you manually edited skill files.
search_skills(query="deploy")           # 搜索并自动安装最佳匹配Skill
search_skills(query="trading")          # 搜索并自动安装
search_skills(query="k8s", auto_install=false)  # 仅搜索，不安装
search_skills()                         # 列出所有已安装的Skill
在
search_skills
安装Skill后，该Skill会立即可用。仅当您手动编辑Skill文件时，才需要调用
skill_refresh()
。

What NOT to do

禁止操作

  • Do NOT 
    curl
    GitHub repos to browse/download skills
  • Do NOT 
    mkdir -p skills/<name>
    and manually write SKILL.md
  • Do NOT use 
    web_fetch
    to download skill files
  • Do NOT use the old gateway search/install endpoints (they no longer exist)
  • 请勿使用curl获取GitHub仓库以浏览/下载Skill
  • 请勿创建
    mkdir -p skills/<name>
    并手动编写SKILL.md
  • 请勿使用
    web_fetch
    下载Skill文件
  • 请勿使用旧版网关的搜索/安装端点（它们已不再可用）

Publishing (Starchild Only)

发布（仅限Starchild）

Publishing still uses the gateway. Only Starchild-authored skills can be published.
发布仍需通过网关进行。只有Starchild开发的Skill才可发布。

SKILL.md Requirements

SKILL.md 要求

yaml
---
name: my-skill
version: 1.0.0
description: What this skill does
author: your-name
tags: [tag1, tag2]
---
FieldRequiredRules
name
YesLowercase, alphanumeric + hyphens, 2-64 chars
version
YesSemver (e.g. 
1.0.0
) — immutable once published
description
RecommendedShort summary for search
author
RecommendedAuthor name
tags
RecommendedArray of tags for discoverability
yaml
---
name: my-skill
version: 1.0.0
description: What this skill does
author: your-name
tags: [tag1, tag2]
---
字段是否必填规则
name
是小写字母、数字和连字符，长度2-64字符
version
是遵循Semver规范（例如
1.0.0
）——发布后不可修改
description
推荐用于搜索的简短摘要
author
推荐作者名称
tags
推荐用于提高可发现性的标签数组

Publish Workflow

发布流程

Step 1: Validate the skill directory
bash
SKILL_DIR="./skills/my-skill"
head -20 "$SKILL_DIR/SKILL.md"
Step 2: Get OIDC token
bash
TOKEN=$(curl -s --unix-socket /.fly/api \
  -X POST -H "Content-Type: application/json" \
  "http://localhost/v1/tokens/oidc" \
  -d '{"aud": "skills-market-gateway"}')
Step 3: Build and send publish request
bash
SKILL_DIR="./skills/my-skill"
GATEWAY="https://skills-market-gateway.fly.dev"

PAYLOAD=$(python3 -c "
import os, json
files = {}
for root, dirs, fnames in os.walk('$SKILL_DIR'):
    for f in fnames:
        full = os.path.join(root, f)
        rel = os.path.relpath(full, '$SKILL_DIR')
        with open(full) as fh:
            files[rel] = fh.read()
print(json.dumps({'files': files}))
")

curl -s -X POST "$GATEWAY/skills/publish" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d "$PAYLOAD" | python3 -m json.tool
步骤1：验证Skill目录
bash
SKILL_DIR="./skills/my-skill"
head -20 "$SKILL_DIR/SKILL.md"
步骤2：获取OIDC令牌
bash
TOKEN=$(curl -s --unix-socket /.fly/api \
  -X POST -H "Content-Type: application/json" \
  "http://localhost/v1/tokens/oidc" \
  -d '{"aud": "skills-market-gateway"}')
步骤3：构建并发送发布请求
bash
SKILL_DIR="./skills/my-skill"
GATEWAY="https://skills-market-gateway.fly.dev"

PAYLOAD=$(python3 -c "
import os, json
files = {}
for root, dirs, fnames in os.walk('$SKILL_DIR'):
    for f in fnames:
        full = os.path.join(root, f)
        rel = os.path.relpath(full, '$SKILL_DIR')
        with open(full) as fh:
            files[rel] = fh.read()
print(json.dumps({'files': files}))
")

curl -s -X POST "$GATEWAY/skills/publish" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d "$PAYLOAD" | python3 -m json.tool

Response (201)

响应（201）

json
{
  "namespace": "@554",
  "name": "my-skill",
  "version": "1.0.0",
  "tag": "@554/my-skill@1.0.0",
  "download_url": "https://github.com/.../bundle.zip",
  "release_url": "https://github.com/.../releases/tag/..."
}
json
{
  "namespace": "@554",
  "name": "my-skill",
  "version": "1.0.0",
  "tag": "@554/my-skill@1.0.0",
  "download_url": "https://github.com/.../bundle.zip",
  "release_url": "https://github.com/.../releases/tag/..."
}

Version Rules

版本规则

  • Each version is immutable — once published, it cannot be overwritten.
  • To update, bump the version and publish again.
  • 每个版本都是不可修改的——一旦发布，就无法覆盖。
  • 如需更新，请升级版本号后重新发布。

Decision Tree

决策树

User wants to find/install a skill
  → Use search_skills(query) tool — it searches all sources and auto-installs
  → NEVER curl GitHub or manually download files

User wants to list installed skills
  → Use search_skills() with no query

User wants to publish a skill
  → Validate SKILL.md frontmatter
  → Get OIDC token (audience: skills-market-gateway)
  → POST to /skills/publish

User wants to create a new skill
  → Read the skill-creator skill first
用户想要查找/安装Skill
  → 使用search_skills(query)工具——它会搜索所有来源并自动安装
  → 绝不要使用curl访问GitHub或手动下载文件

用户想要列出已安装的Skill
  → 调用不带参数的search_skills()

用户想要发布Skill
  → 验证SKILL.md的前置元数据
  → 获取OIDC令牌（受众：skills-market-gateway）
  → 向/skills/publish发送POST请求

用户想要创建新Skill
  → 先阅读skill-creator skill的文档