skillmarketplace

技能市场

搜索和安装技能

始终使用 search_skills 工具。 不要手动 curl、浏览 GitHub 或下载 SKILL.md 文件。

search_skills 会自动完成所有操作：

1. 本地 — 首先检查已安装的技能
2. Starchild 社区 — 搜索 community-skills 索引
3. skills.sh — 搜索全球技能生态（OpenClaw、Vercel、Anthropic 等）
4. 自动安装 — 通过 npx skills add 安装最佳匹配项（默认：auto_install=true）

用法

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

search_skills 安装技能后，该技能即可立即使用。只有在手动编辑技能文件后，才调用 skill_refresh()。

不要这样做

• 不要通过 curl GitHub 仓库来浏览或下载技能
• 不要使用 mkdir -p skills/<name> 并手动编写 SKILL.md
• 不要使用 web_fetch 下载技能文件
• 不要使用旧版 gateway 搜索/安装端点（这些端点已不存在）

---

发布（仅限 Starchild）

发布仍通过 gateway 进行。只有由 Starchild 编写的技能才能发布。

SKILL.md 要求

---
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	建议	用于提升可发现性的标签数组

发布工作流

步骤 1：验证技能目录

SKILL_DIR="./skills/my-skill"
head -20 "$SKILL_DIR/SKILL.md"

步骤 2：获取 OIDC 令牌

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：构建并发送发布请求

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

响应（201）

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

版本规则

• 每个版本都是不可变的 — 发布后无法覆盖。
• 如需更新，请提升版本号后重新发布。

---

决策树

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