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() を呼び出すのは、スキルファイルを手動で編集した場合だけにしてください。

やってはいけないこと

• スキルを閲覧・ダウンロードするために GitHub リポジトリを curl しないでください
• mkdir -p skills/<name> して手動で SKILL.md を書かないでください
• スキルファイルをダウンロードするために web_fetch を使用しないでください
• 旧ゲートウェイの検索/インストールエンドポイントを使用しないでください(それらはもう存在しません)

---

公開(Starchild のみ)

公開には引き続きゲートウェイを使用します。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