1---
2name: skillmarketplace
3version: 4.0.1
4description: |
5  Search, install, and publish skills across official, community, and global registries.
6 
7  Use when finding or sharing skills (e.g. install a "funding rate" skill, list installed skills, publish my custom skill to the registry).
8 
9metadata:
10  starchild:
11    emoji: "📦"
12    skillKey: skillmarketplace
13 
14user-invocable: true
15 
16---
17 
18# Skill Market
19 
20## Searching & Installing Skills
21 
22**Always use the `search_skills` tool.** Do NOT manually curl, browse GitHub, or download SKILL.md files.
23 
24`search_skills` does everything automatically:
25 
261. **Local** — checks installed skills first
272. **Starchild community** — searches community-skills index
283. **skills.sh** — searches the global skills ecosystem (OpenClaw, Vercel, Anthropic, etc.)
294. **Auto-install** — installs the best match via `npx skills add` (default: `auto_install=true`)
30 
31### Usage
32 
33```
34search_skills(query="deploy")           # search + auto-install best match
35search_skills(query="trading")          # search + auto-install
36search_skills(query="k8s", auto_install=false)  # search only, don't install
37search_skills()                         # list all installed skills
38```
39 
40After `search_skills` installs a skill, it's immediately available. Call `skill_refresh()` only if you manually edited skill files.
41 
42### What NOT to do
43 
44- Do NOT `curl` GitHub repos to browse/download skills
45- Do NOT `mkdir -p skills/<name>` and manually write SKILL.md
46- Do NOT use `web_fetch` to download skill files
47- Do NOT use the old gateway search/install endpoints (they no longer exist)
48 
49---
50 
51## Publishing (Starchild Only)
52 
53Publishing still uses the gateway. Only Starchild-authored skills can be published.
54 
55### SKILL.md Requirements
56 
57```yaml
58---
59name: my-skill
60version: 1.0.0
61description: What this skill does
62author: your-name
63tags: [tag1, tag2]
64---
65```
66 
67| Field | Required | Rules |
68|-------|----------|-------|
69| `name` | Yes | Lowercase, alphanumeric + hyphens, 2-64 chars |
70| `version` | Yes | Semver (e.g. `1.0.0`) — immutable once published |
71| `description` | Recommended | Short summary for search |
72| `author` | Recommended | Author name |
73| `tags` | Recommended | Array of tags for discoverability |
74 
75### Publish Workflow
76 
77**Step 1: Validate the skill directory**
78 
79```bash
80SKILL_DIR="./skills/my-skill"
81head -20 "$SKILL_DIR/SKILL.md"
82```
83 
84**Step 2: Get OIDC token**
85 
86```bash
87TOKEN=$(curl -s --unix-socket /.fly/api \
88  -X POST -H "Content-Type: application/json" \
89  "http://localhost/v1/tokens/oidc" \
90  -d '{"aud": "skills-market-gateway"}')
91```
92 
93**Step 3: Build and send publish request**
94 
95```bash
96SKILL_DIR="./skills/my-skill"
97GATEWAY="https://skills-market-gateway.fly.dev"
98 
99PAYLOAD=$(python3 -c "
100import os, json
101files = {}
102for root, dirs, fnames in os.walk('$SKILL_DIR'):
103    for f in fnames:
104        full = os.path.join(root, f)
105        rel = os.path.relpath(full, '$SKILL_DIR')
106        with open(full) as fh:
107            files[rel] = fh.read()
108print(json.dumps({'files': files}))
109")
110 
111curl -s -X POST "$GATEWAY/skills/publish" \
112  -H "Authorization: Bearer $TOKEN" \
113  -H "Content-Type: application/json" \
114  -d "$PAYLOAD" | python3 -m json.tool
115```
116 
117### Response (201)
118 
119```json
120{
121  "namespace": "@554",
122  "name": "my-skill",
123  "version": "1.0.0",
124  "tag": "@554/[email protected]",
125  "download_url": "https://github.com/.../bundle.zip",
126  "release_url": "https://github.com/.../releases/tag/..."
127}
128```
129 
130### Version Rules
131 
132- Each version is **immutable** — once published, it cannot be overwritten.
133- To update, bump the version and publish again.
134 
135---
136 
137## Decision Tree
138 
139```
140User wants to find/install a skill
141  → Use search_skills(query) tool — it searches all sources and auto-installs
142  → NEVER curl GitHub or manually download files
143 
144User wants to list installed skills
145  → Use search_skills() with no query
146 
147User wants to publish a skill
148  → Validate SKILL.md frontmatter
149  → Get OIDC token (audience: skills-market-gateway)
150  → POST to /skills/publish
151 
152User wants to create a new skill
153  → Read the skill-creator skill first
154```
155