Skip to content

Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.

feat(skills): make the skills pack installable with npx skills add, with a spec validator and a clean-directory install test

nirholas453043b81e60
diff --git a/.agents/skills/anatomy/SKILL.md b/.agents/skills/anatomy/SKILL.md
index 1ec363690..d04aae515 100644
--- a/.agents/skills/anatomy/SKILL.md
+++ b/.agents/skills/anatomy/SKILL.md
@@ -5,7 +5,7 @@ when_to_use: The user wants a machine or mechanism explained visually and intera
license: MIT
metadata:
category: 3d/creative
- cross-platform-safe: true
+ cross-platform-safe: "true"
pack: three-ws-skills
---
diff --git a/.agents/skills/authenticate-wallet/SKILL.md b/.agents/skills/authenticate-wallet/SKILL.md
index 4e23ae573..3de491adb 100644
--- a/.agents/skills/authenticate-wallet/SKILL.md
+++ b/.agents/skills/authenticate-wallet/SKILL.md
@@ -3,10 +3,10 @@ name: authenticate-wallet
description: Sign in to the wallet. Use when you or the user want to log in, sign in, connect, or set up the wallet, or when any wallet operation fails with authentication or "not signed in" errors. This skill is a prerequisite before sending, trading, or funding.
user-invocable: true
disable-model-invocation: false
-allowed-tools: ["Bash(npx [email protected] status*)", "Bash(npx [email protected] auth *)", "Bash(npx [email protected] balance*)", "Bash(npx [email protected] address*)", "Bash(npx [email protected] show*)"]
+allowed-tools: "Bash(npx [email protected] status*) Bash(npx [email protected] auth *) Bash(npx [email protected] balance*) Bash(npx [email protected] address*) Bash(npx [email protected] show*)"
metadata:
category: wallet/payments
- cross-platform-safe: false
+ cross-platform-safe: "false"
pack: three-ws-skills
---
diff --git a/.agents/skills/build-an-agent-skill/SKILL.md b/.agents/skills/build-an-agent-skill/SKILL.md
index ded522333..cdbcd7469 100644
--- a/.agents/skills/build-an-agent-skill/SKILL.md
+++ b/.agents/skills/build-an-agent-skill/SKILL.md
@@ -1,11 +1,12 @@
---
name: build-an-agent-skill
description: Write a real three.ws agent skill bundle (manifest.json + SKILL.md + tools.json + handlers.js) that gives a 3D agent a new capability, then install it on an agent and test it. Use when you or the user want to build, write, author, or code a custom skill, capability, tool, or ability for a three.ws agent or an <agent-3d> embed ("give my agent a new skill", "make my agent able to check the weather", "write a custom tool for my avatar", "add a gesture skill"). Covers the four-file bundle layout, the handler context API, the sandbox limits, trust policy, and how to install the bundle.
-when_to_use: The user wants an agent to be able to DO something new. To then charge for it, use sell-an-agent-skill. To create the agent itself first, use create-a-three-ws-agent. This is not about Claude skills: it is the three.ws in-app skill format that runs inside the agent runtime.
+when_to_use: >-
+ The user wants an agent to be able to DO something new. To then charge for it, use sell-an-agent-skill. To create the agent itself first, use create-a-three-ws-agent. This is not about Claude skills: it is the three.ws in-app skill format that runs inside the agent runtime.
license: MIT
metadata:
category: platform/agents
- cross-platform-safe: false
+ cross-platform-safe: "false"
pack: three-ws-skills
---
diff --git a/.agents/skills/connect-three-ws-mcp/SKILL.md b/.agents/skills/connect-three-ws-mcp/SKILL.md
index 67ea3862e..942f4c975 100644
--- a/.agents/skills/connect-three-ws-mcp/SKILL.md
+++ b/.agents/skills/connect-three-ws-mcp/SKILL.md
@@ -5,7 +5,7 @@ when_to_use: The user wants the tools available inside their client rather than
license: MIT
metadata:
category: platform/agents
- cross-platform-safe: false
+ cross-platform-safe: "false"
pack: three-ws-skills
---
diff --git a/.agents/skills/create-3d-avatar/SKILL.md b/.agents/skills/create-3d-avatar/SKILL.md
index 716643fee..e098e1e39 100644
--- a/.agents/skills/create-3d-avatar/SKILL.md
+++ b/.agents/skills/create-3d-avatar/SKILL.md
@@ -5,7 +5,7 @@ when_to_use: User wants a posable/animatable humanoid character. For a static ob
license: MIT
metadata:
category: 3d/creative
- cross-platform-safe: true
+ cross-platform-safe: "true"
pack: three-ws-skills
---
diff --git a/.agents/skills/create-a-three-ws-agent/SKILL.md b/.agents/skills/create-a-three-ws-agent/SKILL.md
index ecf139c98..2c992056d 100644
--- a/.agents/skills/create-a-three-ws-agent/SKILL.md
+++ b/.agents/skills/create-a-three-ws-agent/SKILL.md
@@ -5,7 +5,7 @@ when_to_use: The user wants an agent that exists on three.ws (a record with a pa
license: MIT
metadata:
category: platform/agents
- cross-platform-safe: false
+ cross-platform-safe: "false"
pack: three-ws-skills
---
diff --git a/.agents/skills/embed-three-ws-avatar/SKILL.md b/.agents/skills/embed-three-ws-avatar/SKILL.md
index 74cac29be..9545b8b2e 100644
--- a/.agents/skills/embed-three-ws-avatar/SKILL.md
+++ b/.agents/skills/embed-three-ws-avatar/SKILL.md
@@ -5,7 +5,7 @@ when_to_use: A site or app (any framework, or plain HTML) should display or cont
license: MIT
metadata:
category: 3d/creative
- cross-platform-safe: true
+ cross-platform-safe: "true"
pack: three-ws-skills
---
diff --git a/.agents/skills/find-3d-assets/SKILL.md b/.agents/skills/find-3d-assets/SKILL.md
index a8bc902ce..2f1268027 100644
--- a/.agents/skills/find-3d-assets/SKILL.md
+++ b/.agents/skills/find-3d-assets/SKILL.md
@@ -1,11 +1,12 @@
---
name: find-3d-assets
-description: Search thousands of ready-made 3D assets on three.ws (CC0 props and objects, rigged humanoid characters, motion clips) and get paste-ready code or a downloaded file. Use when you or the user need a 3D model, prop, object, character, or animation for a scene, site, game, or app ("I need a 3D chair", "find a rigged character", "is there a wave animation", "add a lamp model to my page"). Free: no account, no API key, no payment. Check here BEFORE generating a model from scratch.
+description: >-
+ Search thousands of ready-made 3D assets on three.ws (CC0 props and objects, rigged humanoid characters, motion clips) and get paste-ready code or a downloaded file. Use when you or the user need a 3D model, prop, object, character, or animation for a scene, site, game, or app ("I need a 3D chair", "find a rigged character", "is there a wave animation", "add a lamp model to my page"). Free: no account, no API key, no payment. Check here BEFORE generating a model from scratch.
when_to_use: Something needs a 3D asset and a ready-made one would do. If the catalog has no match, fall through to generate-3d-model (props) or create-3d-avatar (characters). To put an asset you already have on a page, use embed-three-ws-avatar.
license: MIT
metadata:
category: 3d/creative
- cross-platform-safe: true
+ cross-platform-safe: "true"
pack: three-ws-skills
---
diff --git a/.agents/skills/fund/SKILL.md b/.agents/skills/fund/SKILL.md
index f1c465b4d..09ee15523 100644
--- a/.agents/skills/fund/SKILL.md
+++ b/.agents/skills/fund/SKILL.md
@@ -3,10 +3,10 @@ name: fund
description: Add money to the wallet. Use when you or the user want to fund, deposit, top up, load, buy USDC, add funds, onramp, or get USDC. Also use when the wallet has insufficient balance for a send or trade operation, or when someone asks "how do I get USDC?"
user-invocable: true
disable-model-invocation: false
-allowed-tools: ["Bash(npx [email protected] status*)", "Bash(npx [email protected] show*)", "Bash(npx [email protected] address*)", "Bash(npx [email protected] balance*)"]
+allowed-tools: "Bash(npx [email protected] status*) Bash(npx [email protected] show*) Bash(npx [email protected] address*) Bash(npx [email protected] balance*)"
metadata:
category: wallet/payments
- cross-platform-safe: false
+ cross-platform-safe: "false"
pack: three-ws-skills
---
diff --git a/.agents/skills/gcp-triage/SKILL.md b/.agents/skills/gcp-triage/SKILL.md
index 26dd604c0..6d59011a1 100644
--- a/.agents/skills/gcp-triage/SKILL.md
+++ b/.agents/skills/gcp-triage/SKILL.md
@@ -5,7 +5,7 @@ when_to_use: Production health checks, log diagnosis, error triage, and the recu
license: MIT
metadata:
category: ops/production
- cross-platform-safe: false
+ cross-platform-safe: "false"
pack: three-ws-ops
---
diff --git a/.agents/skills/generate-3d-model/SKILL.md b/.agents/skills/generate-3d-model/SKILL.md
index 00c492089..401d8d78e 100644
--- a/.agents/skills/generate-3d-model/SKILL.md
+++ b/.agents/skills/generate-3d-model/SKILL.md
@@ -5,7 +5,7 @@ when_to_use: User wants a 3D object/asset/prop from text. For a posable characte
license: MIT
metadata:
category: 3d/creative
- cross-platform-safe: true
+ cross-platform-safe: "true"
pack: three-ws-skills
---
diff --git a/.agents/skills/hire-an-agent/SKILL.md b/.agents/skills/hire-an-agent/SKILL.md
index 9f08e7de7..ba20814b1 100644
--- a/.agents/skills/hire-an-agent/SKILL.md
+++ b/.agents/skills/hire-an-agent/SKILL.md
@@ -5,7 +5,7 @@ when_to_use: The demand side of the three.ws marketplace. To sell instead of buy
license: MIT
metadata:
category: platform/agents
- cross-platform-safe: false
+ cross-platform-safe: "false"
pack: three-ws-skills
---
diff --git a/.agents/skills/monetize-service/SKILL.md b/.agents/skills/monetize-service/SKILL.md
index 268d851da..6ef69ee5a 100644
--- a/.agents/skills/monetize-service/SKILL.md
+++ b/.agents/skills/monetize-service/SKILL.md
@@ -3,10 +3,10 @@ name: monetize-service
description: Build and deploy a paid API that other agents can pay to use via x402. Use when you or the user want to monetize an API, make money, earn money, offer a service, sell a service to other agents, charge for endpoints, create a paid endpoint, or set up a paid service. Covers "make money by offering an endpoint", "sell a service", "monetize your data", "create a paid API".
user-invocable: true
disable-model-invocation: false
-allowed-tools: ["Bash(npx [email protected] status*)", "Bash(npx [email protected] address*)", "Bash(npx [email protected] x402 details *)", "Bash(npx [email protected] x402 pay *)", "Bash(npm *)", "Bash(node *)", "Bash(curl *)", "Bash(mkdir *)"]
+allowed-tools: "Bash(npx [email protected] status*) Bash(npx [email protected] address*) Bash(npx [email protected] x402 details *) Bash(npx [email protected] x402 pay *) Bash(npm *) Bash(node *) Bash(curl *) Bash(mkdir *)"
metadata:
category: wallet/payments
- cross-platform-safe: false
+ cross-platform-safe: "false"
pack: three-ws-skills
---
diff --git a/.agents/skills/pay-for-service/SKILL.md b/.agents/skills/pay-for-service/SKILL.md
index bb0cd0749..496d6c0a9 100644
--- a/.agents/skills/pay-for-service/SKILL.md
+++ b/.agents/skills/pay-for-service/SKILL.md
@@ -3,10 +3,10 @@ name: pay-for-service
description: Make a paid API request to an x402 endpoint with automatic USDC payment. Use when you or the user want to call a paid API, make an x402 request, use a paid service, or pay for an API call. Use after finding a service with search-for-service. This is the three.ws-native x402 payer (awal, USDC on Base) and is the default; defer to okx-agent-payments-protocol only when the user names OKX/OnchainOS, or the 402 is channel/voucher/session/permit2/MPP/a2a-pay based rather than a plain awal x402 pay.
user-invocable: true
disable-model-invocation: false
-allowed-tools: ["Bash(npx [email protected] status*)", "Bash(npx [email protected] balance*)", "Bash(npx [email protected] x402 pay *)"]
+allowed-tools: "Bash(npx [email protected] status*) Bash(npx [email protected] balance*) Bash(npx [email protected] x402 pay *)"
metadata:
category: wallet/payments
- cross-platform-safe: false
+ cross-platform-safe: "false"
pack: three-ws-skills
---
diff --git a/.agents/skills/query-onchain-data/SKILL.md b/.agents/skills/query-onchain-data/SKILL.md
index f1b3afd7f..42738e988 100644
--- a/.agents/skills/query-onchain-data/SKILL.md
+++ b/.agents/skills/query-onchain-data/SKILL.md
@@ -3,10 +3,10 @@ name: query-onchain-data
description: Query onchain data on Base using the CDP SQL API via x402. Use when you or your user want to view onchain information about decoded blocks, transactions, and events.
user-invocable: true
disable-model-invocation: false
-allowed-tools: ["Bash(npx [email protected] status*)", "Bash(npx [email protected] balance*)", "Bash(npx [email protected] x402 pay *)"]
+allowed-tools: "Bash(npx [email protected] status*) Bash(npx [email protected] balance*) Bash(npx [email protected] x402 pay *)"
metadata:
category: wallet/payments
- cross-platform-safe: false
+ cross-platform-safe: "false"
pack: three-ws-skills
---
diff --git a/.agents/skills/rig-a-model/SKILL.md b/.agents/skills/rig-a-model/SKILL.md
index 2bb2d5762..2662ab99f 100644
--- a/.agents/skills/rig-a-model/SKILL.md
+++ b/.agents/skills/rig-a-model/SKILL.md
@@ -5,7 +5,7 @@ when_to_use: User already has a GLB (a URL) and wants it rigged. To generate a n
license: MIT
metadata:
category: 3d/creative
- cross-platform-safe: true
+ cross-platform-safe: "true"
pack: three-ws-skills
---
diff --git a/.agents/skills/search-for-service/SKILL.md b/.agents/skills/search-for-service/SKILL.md
index e5526d019..c50c56089 100644
--- a/.agents/skills/search-for-service/SKILL.md
+++ b/.agents/skills/search-for-service/SKILL.md
@@ -1,12 +1,13 @@
---
name: search-for-service
-description: Search and browse the x402 bazaar marketplace for paid API services. Use when you or the user want to find available services, see what's available, discover APIs, or need an external service to accomplish a task. Also use as a fallback when no other skill clearly matches: search the bazaar to see if a paid service exists. Covers "what can I do?", "find me an API for...", "what services are available?", "search for...", "browse the bazaar".
+description: >-
+ Search and browse the x402 bazaar marketplace for paid API services. Use when you or the user want to find available services, see what's available, discover APIs, or need an external service to accomplish a task. Also use as a fallback when no other skill clearly matches: search the bazaar to see if a paid service exists. Covers "what can I do?", "find me an API for...", "what services are available?", "search for...", "browse the bazaar".
user-invocable: true
disable-model-invocation: false
-allowed-tools: ["Bash(npx [email protected] x402 bazaar *)", "Bash(npx [email protected] x402 details *)"]
+allowed-tools: "Bash(npx [email protected] x402 bazaar *) Bash(npx [email protected] x402 details *)"
metadata:
category: wallet/payments
- cross-platform-safe: false
+ cross-platform-safe: "false"
pack: three-ws-skills
---
diff --git a/.agents/skills/sell-an-agent-skill/SKILL.md b/.agents/skills/sell-an-agent-skill/SKILL.md
index 1657fc6b8..0493b052e 100644
--- a/.agents/skills/sell-an-agent-skill/SKILL.md
+++ b/.agents/skills/sell-an-agent-skill/SKILL.md
@@ -5,7 +5,7 @@ when_to_use: The user has a capability and wants income from it. To author the s
license: MIT
metadata:
category: platform/agents
- cross-platform-safe: false
+ cross-platform-safe: "false"
pack: three-ws-skills
---
diff --git a/.agents/skills/send-usdc/SKILL.md b/.agents/skills/send-usdc/SKILL.md
index 44b19a95d..1e3c7b9c7 100644
--- a/.agents/skills/send-usdc/SKILL.md
+++ b/.agents/skills/send-usdc/SKILL.md
@@ -3,10 +3,10 @@ name: send-usdc
description: Send tokens (USDC, ETH, POL, or SOL) to an address or ENS name on Base, Polygon, or Solana. Use when you or the user want to send money, pay someone, transfer tokens, tip, donate, or send funds to a wallet address or .eth name. Covers phrases like "send $5 to", "pay 0x...", "transfer to vitalik.eth", or "send USDC on Solana". This is the three.ws-native wallet (awal) and is the default for sends; defer to okx-agentic-wallet only when the user names OKX, OnchainOS, an OKX-managed / Agentic Wallet account, or an OKX-specific chain/venue (e.g. X Layer).
user-invocable: true
disable-model-invocation: false
-allowed-tools: ["Bash(npx [email protected] status*)", "Bash(npx [email protected] send *)", "Bash(npx [email protected] balance*)"]
+allowed-tools: "Bash(npx [email protected] status*) Bash(npx [email protected] send *) Bash(npx [email protected] balance*)"
metadata:
category: wallet/payments
- cross-platform-safe: false
+ cross-platform-safe: "false"
pack: three-ws-skills
---
diff --git a/.agents/skills/trade/SKILL.md b/.agents/skills/trade/SKILL.md
index 57cfda36b..0c7a0420f 100644
--- a/.agents/skills/trade/SKILL.md
+++ b/.agents/skills/trade/SKILL.md
@@ -3,10 +3,10 @@ name: trade
description: Swap or trade tokens on Base or Polygon. Use when you or the user want to trade, swap, exchange, buy, sell, or convert between tokens like USDC, ETH, and POL. Covers phrases like "buy ETH", "sell ETH for USDC", "convert USDC to ETH", "get some ETH", "buy POL". This is the three.ws-native wallet (awal) and is the default for swaps; defer to okx-dex-swap only when the user names OKX, OnchainOS, an OKX-managed account, a named DEX/DApp venue, or an OKX-specific chain (e.g. X Layer, BSC, Arbitrum).
user-invocable: true
disable-model-invocation: false
-allowed-tools: ["Bash(npx [email protected] status*)", "Bash(npx [email protected] trade *)", "Bash(npx [email protected] balance*)"]
+allowed-tools: "Bash(npx [email protected] status*) Bash(npx [email protected] trade *) Bash(npx [email protected] balance*)"
metadata:
category: wallet/payments
- cross-platform-safe: false
+ cross-platform-safe: "false"
pack: three-ws-skills
---
diff --git a/.agents/skills/x402/SKILL.md b/.agents/skills/x402/SKILL.md
index debbe3006..b6ba9740d 100644
--- a/.agents/skills/x402/SKILL.md
+++ b/.agents/skills/x402/SKILL.md
@@ -5,7 +5,7 @@ user-invocable: true
disable-model-invocation: false
metadata:
category: wallet/payments
- cross-platform-safe: false
+ cross-platform-safe: "false"
pack: three-ws-skills
---
diff --git a/STRUCTURE.md b/STRUCTURE.md
index b5e2d2e66..d74189104 100644
--- a/STRUCTURE.md
+++ b/STRUCTURE.md
@@ -161,7 +161,6 @@ packages, a generated standalone GitHub mirror). See
| Conversational refinement + remix economy | Iterate: [api/_mcp-studio/tools.js](api/_mcp-studio/tools.js) `refine_model` (free, on `/api/mcp-studio`) + [mcp-server/src/tools/refine-model.js](mcp-server/src/tools/refine-model.js) (paid stdio, $0.25); shared lineage core [mcp-server/src/tools/_lineage.js](mcp-server/src/tools/_lineage.js). Remix (paid track): feed [api/remix-feed.js](api/remix-feed.js) `→ /api/remix-feed` (free browse/publish/lineage), settlement [api/x402/remix-asset.js](api/x402/remix-asset.js) `→ /api/x402/remix-asset` + core [api/_lib/remix-settlement.js](api/_lib/remix-settlement.js) + split math [api/_lib/remix-royalty.js](api/_lib/remix-royalty.js). Docs [docs/remix.md](docs/remix.md), [docs/mcp-studio.md](docs/mcp-studio.md). | Live | Talk to a model to iterate it ("make it metallic") — real anchored re-generation with a revertable/branchable version lineage rendered as a viewer version strip; free on both the OpenAI 3D Studio and the paid MCP server. Creators publish a finished model as remixable (provenance + license + royalty on the existing `forge_creations` rows — no parallel store); another agent pays $0.25 USDC to remix it and a creator-set royalty (≤20%, capped) routes on-chain to the original creator via the audited `transferSolanaUSDC` rail. Split/caps/payout unit-tested ([tests/remix-settlement.test.js](tests/remix-settlement.test.js), [tests/remix-royalty.test.js](tests/remix-royalty.test.js), [tests/refine-lineage.test.js](tests/refine-lineage.test.js)). Free track stays crypto-free. Prompt 09. |
| Terminal renderer (3D in a shell, no GPU) | Renderer core [packages/tty-3d/](packages/tty-3d) (`@three-ws/tty-3d`, CLI `three-tty`), hosted stream [api/tty.js](api/tty.js) `→ /tty`, `/tty/:id`, `/api/tty`, page [pages/tty.html](pages/tty.html) + [src/tty-page.js](src/tty-page.js) `→ /tty`. Docs: [docs/tty.md](docs/tty.md). Tests: [packages/tty-3d/tests/tty-3d.test.js](packages/tty-3d/tests/tty-3d.test.js), [tests/api-tty.test.js](tests/api-tty.test.js) | Live | `curl three.ws/tty` and a rigged agent walks in your terminal, with nothing installed on either side. A pure-CPU software rasterizer (z-buffer, per-vertex linear blend skinning off the glTF animation samplers, meshopt decode on the way in) draws into a framebuffer the size of the caller's terminal and encodes it as `▀` half-blocks, so one cell carries two independently coloured pixels and pixels come out square. The server streams paced frames as `text/plain`, so the HTTP response IS the animation. Sibling of [packages/tty-avatar/](packages/tty-avatar), which adds moods, avatar-id resolution and Claude Code hooks on top of a terminal renderer but deliberately does not do skeletal animation; this package owns the 3D. |
| Restyle Studio (material/PBR editor + AI restyle + variants) | [pages/restyle.html](pages/restyle.html) `→ /restyle`, [src/restyle.js](src/restyle.js). PBR preset/variant library [packages/viewer-presets/src/materials.js](packages/viewer-presets/src/materials.js) (`@three-ws/viewer-presets`). AI restyle + persistence core [api/_lib/material-studio-store.js](api/_lib/material-studio-store.js), free hosted endpoint [api/material-studio.js](api/material-studio.js) `→ /api/material-studio`; paid agent twin [mcp-server/src/tools/restyle-material.js](mcp-server/src/tools/restyle-material.js) (`restyle_material`, $0.05 stdio MCP), thin core [mcp-server/src/tools/_material-core.js](mcp-server/src/tools/_material-core.js). Shares the `refine_model` lineage core ([mcp-server/src/tools/_lineage.js](mcp-server/src/tools/_lineage.js)) so a restyle/variant is just another kind of version, feeding prompt 09 remix. Docs: [docs/restyle.md](docs/restyle.md), [docs/mcp-tools.md](docs/mcp-tools.md). | Live | Re-skin any GLB without regenerating its mesh: live PBR editing (color/metalness/roughness/emissive/texture) with a one-click preset library (18 looks: chrome, gold, copper, brushed steel, gunmetal, matte, glossy, rubber, ceramic, glass, real glass, wood, stone, fabric, skin, car paint, neon, holographic), seeded reproducible colorway variants (mulberry32 PRNG, so the same base plus seed yields the same set), and free-text AI restyle ("make it chrome", "cyberpunk neon") via IBM Granite-proposed PBR factors applied + re-exported server-side. Every AI restyle / saved checkpoint mints a real, `gltf-validator`-checked, durably-stored GLB recorded in an immutable parent to child lineage: non-destructive in the durable sense, not just an in-browser Reset. Every restyle, variant, and HoloPart part regeneration is checked against its own source with [Model Diff](docs/model-diff.md)'s engine via [api/_lib/preserve-contract.js](api/_lib/preserve-contract.js) before it is ever persisted: topology, UVs, skeleton, skin and clips must come back unchanged (a part regenerate relaxes that to skeleton and clips, since the selected part's own shape is meant to change), or the operation throws instead of returning a URL. Each lineage step with a parent exposes a "Diff" link straight to the Model Diff page, pre-loaded with that exact before/after pair. Every server failure surfaces the API's own `error_description`, and a storage outage says so and points at Export GLB, which is wholly in-browser. Roadmap prompt 06. |
-| Renderer factory (opt-in WebGPU) | [src/renderer-factory.js](src/renderer-factory.js), TSL view effects [src/restyle-effects.js](src/restyle-effects.js), bench [scripts/renderer-bench.mjs](scripts/renderer-bench.mjs) | Live (Restyle only) | WebGPU when the page opts in with `?renderer=webgpu` or a `renderer` attribute and an adapter initialises, classic WebGL2 otherwise. Wired into Restyle Studio; the main viewer stays on WebGL2 until its post-processing moves to TSL. Docs: [docs/webgpu-renderer.md](docs/webgpu-renderer.md). Tests: [tests/renderer-factory.test.js](tests/renderer-factory.test.js) |
| Embodiment: a living agent body in the chat | Hosted embed [pages/embodiment/embed.html](pages/embodiment/embed.html) `→ /embodiment/embed` (Vite input + vercel route, `frame-ancestors *`); engine [apps-sdk/embodiment/embodiment-stage.js](apps-sdk/embodiment/embodiment-stage.js) (`EmbodimentStage`) + [overlay.js](apps-sdk/embodiment/overlay.js); persona tools (free) [api/_mcp-studio/persona-tools.js](api/_mcp-studio/persona-tools.js) → `/api/mcp-studio` (`create_agent_persona`, `get_agent_persona`, `persona_say`; deliberately absent from the ChatGPT plugin surface `/api/mcp-chatgpt`, because their widget needs `frameDomains`) and (paid) [api/_mcp3d/tools/studio.js](api/_mcp3d/tools/studio.js); shared inline-body artifact [api/_lib/embodiment-artifact.js](api/_lib/embodiment-artifact.js); identity store [api/_lib/persona-store.js](api/_lib/persona-store.js) (Postgres `agent_personas` + fs fallback + durable R2 GLB); reload route [api/mcp3d/persona.js](api/mcp3d/persona.js) `→ /api/mcp3d/persona`; live chain-state feed [api/mcp3d/persona-identity.js](api/mcp3d/persona-identity.js) `→ /api/mcp3d/persona-identity` (polled only when the embed is opened with `?wallet=1`). Emotion/rig/lip-sync cores under [src/embodiment/](src/embodiment) + [src/voice/](src/voice). | Live | A generated avatar becomes a persistent, named body that renders inline in ChatGPT/Claude: it lip-syncs each reply, blends the matching expression + gesture, idles between turns, and reloads by `persona_id` in a fresh session (the id is the capability, no sign-in). Rides the universal canonicalize/retarget clip library; a rig without face morphs animates the jaw, a non-humanoid GLB falls back to a gentle idle (`decideRigMode`/`supportsCanonicalClips`), never a bind-pose T-pose. Zero crypto/token surface. Tests: [tests/persona-store.test.js](tests/persona-store.test.js), [tests/api/persona-resolve-route.test.js](tests/api/persona-resolve-route.test.js), [tests/api/persona-identity-route.test.js](tests/api/persona-identity-route.test.js), [tests/mcp-studio.test.js](tests/mcp-studio.test.js), [tests/embodiment-rig-mode.test.js](tests/embodiment-rig-mode.test.js). Evidence: [prompts/store-submissions/_generated/embodiment/](prompts/store-submissions/_generated/embodiment/). Store-submission prompt 07. |
| Claude.ai artifact embed + builder | Endpoint [api/artifact.js](api/artifact.js) `→ /api/artifact`, prebuilt viewer [public/artifact-viewer.bundle.js](public/artifact-viewer.bundle.js) (source [scripts/artifact-viewer/src.js](scripts/artifact-viewer/src.js), `npm run build:artifact-viewer`), builder page [public/artifact/index.html](public/artifact/index.html) `→ /artifact` + [README](public/artifact/README.md), contract [specs/CLAUDE_ARTIFACT.md](specs/CLAUDE_ARTIFACT.md), vendored sandbox CSP [public/claude-artifact-csp.txt](public/claude-artifact-csp.txt) (refresh: [scripts/refresh-claude-csp.mjs](scripts/refresh-claude-csp.mjs)). | Live | `GET /api/artifact?agent=<uuid>` returns ONE self-contained HTML document with three.js, GLTFLoader, the viewer and the agent GLB all inlined, because Claude's artifact sandbox CSP blocks every external script and fetch. Paste the URL into a Claude conversation and the agent renders inline. The builder page is the pre-flight: it lists real public agents that carry an embeddable avatar (`/api/agents/public?avatar=1`), renders the response in a sandboxed iframe under the same CSP Claude applies, and reports payload size, fetch time, frame render time and sandbox compliance before you paste. Size is graded against the ceiling the endpoint can actually emit (a 6 MB model base64-inlines to 8 MB, plus the 565 KB viewer), not against the raw model cap, so a large-but-accepted artifact is not flagged as over budget. `?model=<glb url>` is the viewer-only lane (allowlisted https origins, SSRF-guarded, 6 MB cap). Tests: [tests/api/artifact.test.js](tests/api/artifact.test.js) pins the generated HTML against the vendored Claude CSP. |
| Avatar Artifact: the standalone shareable viewer | Page [pages/avatar-artifact.html](pages/avatar-artifact.html) `→ /avatar-artifact`, scene + artifact loader [src/avatar-artifact.js](src/avatar-artifact.js), docs [docs/avatar-artifact.md](docs/avatar-artifact.md). | Live | One page, one avatar, no wrapper: the URL you paste into an `<iframe>` on someone else's site or send to a person who has never heard of three.ws. `?agent=<uuid>` renders that agent's avatar from the live public record (the name becomes the heading and the document title, an Open profile link appears), `?model=<glb url>` renders any GLB from the same allowlisted hosts `/api/artifact` enforces, and a bare link renders the house portrait: a procedural figure that tracks cursor, touch and arrow keys. Ships no third-party CDN (three.js is bundled, because an embed host never agreed to a cross-origin script) and suspends its render loop on a hidden tab. An avatar with no baked clips is driven by the shared retargeted `idle` from the universal clip library rather than left in a bind-pose T-pose. Every failure lane (no such agent, private avatar, no avatar yet, blocked host, dead model, no WebGL) has its own sentence and its own next move; the Copy embed snippet carries the artifact parameters so the iframe shows what you were looking at. |
@@ -310,7 +309,7 @@ packages, a generated standalone GitHub mirror). See
| Open source credits | Source logic [scripts/lib/open-source-credits.mjs](scripts/lib/open-source-credits.mjs), generator [scripts/build-open-source-credits.mjs](scripts/build-open-source-credits.mjs) (wired into `npm run prebuild`) → [data/open-source-credits.json](data/open-source-credits.json), endpoint [api/open-source-credits.js](api/open-source-credits.js) `→ GET /api/open-source-credits`, page [pages/open-source.html](pages/open-source.html) `-> /open-source` ([src/open-source.js](src/open-source.js)) | Live | Every third-party dependency, GPU worker model, and free asset source three.ws runs on, grouped by area (rendering, formats and compression, generation models, motion, voice, assets, infrastructure) with its license, upstream link, and what it powers on the platform. Three kinds of entry feed it: every direct npm dependency resolved from its own installed package metadata, hand-curated worker models whose license lives in each worker's README prose (including an honest "not declared upstream" for packages with none, rather than a guessed default), and asset sources like Poly Haven and the CC0 animation packs. A guard test ([tests/open-source-credits.test.js](tests/open-source-credits.test.js)) deep-equals a fresh `buildCredits()` run against the committed dataset, so a new direct dependency added without regenerating it fails the suite instead of rotting silently. In-surface credits point back here: Poly Haven on [pages/objects.html](pages/objects.html) and the object viewer ([src/app-next-overlay.js](src/app-next-overlay.js)), meshoptimizer and glTF-Transform in the Forge export dialog ([src/forge-export.js](src/forge-export.js)), and studio-tier clip source/license in the animation gallery ([src/animations-gallery.js](src/animations-gallery.js)). Docs: [docs/open-source-credits.md](docs/open-source-credits.md) `→ /docs/open-source-credits` |
| Suggested skills (skills from experience) | [api/_lib/skill-candidates.js](api/_lib/skill-candidates.js), pure core [api/_lib/skill-candidate-bundle.js](api/_lib/skill-candidate-bundle.js), handler [api/agents/[id]/skill-candidates.js](api/agents/%5Bid%5D/skill-candidates.js) `→ /api/agents/:id/skill-candidates`, dashboard list [src/dashboard/suggested-skills.js](src/dashboard/suggested-skills.js), MCP tool `list_skill_candidates` in [api/_mcp/tools/custom-skills.js](api/_mcp/tools/custom-skills.js), migration [20261023130000_agent_skill_candidates.sql](api/_lib/migrations/20261023130000_agent_skill_candidates.sql) | Live | After a verified success (a multi-tool run with no error, a passed labor-escrow job, a closed profitable trade) the agent records a candidate with argument shapes only, drafts a `skill/0.1` bundle (model writes prose, the handler is templated), validates it with the marketplace publisher's checks, and lists it on the agent dashboard. The owner installs it on that agent only, publishes it, or dismisses it; nothing installs or publishes without the click. A later run that deviates from an installed skill and succeeds appends a revision proposal instead of editing it. Test [tests/skill-candidates.test.js](tests/skill-candidates.test.js). Docs: [docs/skill-candidates.md](docs/skill-candidates.md) |
| Agent Skills pack | [.agents/skills/](.agents/skills) (canonical) → manifest [.agents/skills/SKILLS.md](.agents/skills/SKILLS.md), [.agents/skills/skills-pack.json](.agents/skills/skills-pack.json); published 3D subset [public/skills/3d-studio/](public/skills/3d-studio) `→ /skills/3d-studio/` | In-repo; bundled in the `three-ws-core` [plugin](.claude-plugin/marketplace.json); 3D subset live on the site | Portable `SKILL.md` folders (Agent Skills open standard) for any Claude surface, in five categories: 3d/creative (cross-platform-safe), platform/agents (create an agent, author and sell its skills, hire other agents, connect a client to the MCP servers), wallet/payments, intel/trading, ops/production. Counts live in the generated manifest, never here. The 3d/creative ones are also published as a public, downloadable bundle at `/skills/3d-studio/` (`three-ws-3d-skills.zip`), which is what an OpenAI Plugin Directory submission uploads on its Skills tab; a skill referencing a tool [api/_mcp-studio/](api/_mcp-studio) does not declare is dropped rather than shipped as a dead path. The same build renders the two entry-point skills from shared facts ([scripts/lib/skill-md-facts.mjs](scripts/lib/skill-md-facts.mjs)): [public/skill.md](public/skill.md) `→ /skill.md` from [data/skill-md.template.md](data/skill-md.template.md), and the Grok variant [public/grok-skill.md](public/grok-skill.md) `→ /grok-skill.md` from [data/grok-skill-md.template.md](data/grok-skill-md.template.md) (links and example calls checked by [tests/grok-skill-file.test.js](tests/grok-skill-file.test.js)). Regenerate manifest: `npm run build:skills-pack` (drift gate `npm run check:skills-pack`); regenerate the published bundle: `npm run build:openai-skills` (drift gate `npm run check:openai-skills`, wired into `npm run gate`). Docs: [docs/agent-skills.md](docs/agent-skills.md) |
-| Standalone skill repos | [scripts/build-standalone-skill-repos.mjs](scripts/build-standalone-skill-repos.mjs) → `.data/standalone-repos/<repo>/` (gitignored) | Generated on demand; publishing is owner-gated | Assembles the three.ws-origin skills into small, publishable repos so an external user installs with one `/plugin marketplace add nirholas/<repo>` instead of cloning this monorepo: `three-ws-skills` (everything), `three-ws-3d-skills` (the crypto-free 3d/creative subset), `three-ws-agent-economy-skills` (wallet/payments + platform/agents). Each output is a complete one-plugin marketplace (`.claude-plugin/{marketplace,plugin}.json`, `skills/`, generated `README.md` with every trigger, `LICENSE`). Built from the same `collectSkills()` the manifest uses, so a copy cannot drift; nothing is committed here. `npm run build:skill-repos`, validate with `npm run check:skill-repos` (wired into `npm run gate`). Docs: [docs/agent-skills.md](docs/agent-skills.md) |
+| Standalone skill repos | [scripts/build-standalone-skill-repos.mjs](scripts/build-standalone-skill-repos.mjs) → `.data/standalone-repos/<repo>/` (gitignored) | Generated on demand; publishing is owner-gated | Assembles the three.ws-origin skills into small, publishable repos so an external user installs with one `npx skills add nirholas/<repo>` (or `/plugin marketplace add nirholas/<repo>`); `npm run check:skills-spec` validates every skill against the Agent Skills spec and `npm run test:skills-install` proves the install in a clean directory instead of cloning this monorepo: `three-ws-skills` (everything), `three-ws-3d-skills` (the crypto-free 3d/creative subset), `three-ws-agent-economy-skills` (wallet/payments + platform/agents). Each output is a complete one-plugin marketplace (`.claude-plugin/{marketplace,plugin}.json`, `skills/`, generated `README.md` with every trigger, `LICENSE`). Built from the same `collectSkills()` the manifest uses, so a copy cannot drift; nothing is committed here. `npm run build:skill-repos`, validate with `npm run check:skill-repos` (wired into `npm run gate`). Docs: [docs/agent-skills.md](docs/agent-skills.md) |
| GitHub growth kit | [scripts/lib/repo-growth-kit.mjs](scripts/lib/repo-growth-kit.mjs), [scripts/boost-github-repos.mjs](scripts/boost-github-repos.mjs), [scripts/build-github-profile.mjs](scripts/build-github-profile.mjs) | Live | Brings every public repo on the nirholas account to discovery best practice, least-starred first: star and share block, AGENTS.md and llms.txt, community health files, tuned settings, plus the generated profile catalog repo. The mirror sync reuses the same module so it never erases the block. Repos about other crypto projects are held back until the owner approves. Docs: [docs/github-growth.md](docs/github-growth.md) |
| Claude Code plugin marketplace | [marketplace/](marketplace) → plugins [three-ws-3d](marketplace/plugins/three-ws-3d), [three-ws-developer](marketplace/plugins/three-ws-developer) | In-repo · installable via `/plugin marketplace add nirholas/three.ws` | 3D generation + rigged avatars inside Claude Code (free lane + paid x402 tools) and developer tooling for building on three.ws. Index: [marketplace/README.md](marketplace/README.md) |
| SNS naming + pay-by-name | [api/sns.js](api/sns.js), [api/sns-subdomain.js](api/sns-subdomain.js), [api/threews/subdomain.js](api/threews/subdomain.js), [api/x402/pay-by-name.js](api/x402/pay-by-name.js), [src/solana/sns-subdomain.js](src/solana/sns-subdomain.js), [pages/threews-claim.html](pages/threews-claim.html) | In-repo | `*.threews.sol` subdomain mint, x402 payments addressed by name. Env: `THREEWS_SOL_PARENT_SECRET_BASE58` |
diff --git a/data/changelog.json b/data/changelog.json
index 9a19e1ac6..8f0a82087 100644
--- a/data/changelog.json
+++ b/data/changelog.json
@@ -3,41 +3,13 @@
"entries": [
{
"date": "2026-10-24",
- "title": "Mention the bot with a coin idea and get a prefilled launch link",
- "summary": "Post \"@trythreews launch Moon Cat $MCAT a cat on the moon\" and the bot answers with a three.ws launch link that already has the name, ticker and description filled in for your agent. The bot never launches anything: you review the cost and sign on three.ws yourself, and the reply says so. Authors whose X account is not linked get a link to sign in and connect it, and linked authors without an agent or a 3D body get a link to create one. The bot is in dry run until the owner turns it live: replies are recorded for review and nothing is posted.",
+ "title": "Install the three.ws skills with one command on any agent runtime",
+ "summary": "Run npx skills add nirholas/three-ws-skills (or the 3D-only and agent-economy repos) to install the three.ws skills into Claude Code, Codex, Cursor and any other runtime that reads the open Agent Skills format. Every skill now passes the Agent Skills spec validator, which fixed 21 skills whose frontmatter some installers could not parse, and an install test proves each repo lists and installs every skill in a clean directory. Publishing the repos is still the owner's step.",
"tags": [
"feature",
- "improvement"
- ],
- "link": "/grok"
- },
- {
- "date": "2026-10-23",
- "title": "Token due diligence: insiders, snipers, bundlers, fresh wallets and a funding graph",
- "summary": "Every Solana token now has holder due diligence computed from chain data we read ourselves: insider hold rate, sniper share, bundler exposure, fresh-wallet share and ratio, and smart-money holders scored from our own tracked wallet history. The /three token page shows the fields, each linked to its definition, plus a two-hop funding force graph. Agents can set max_insider_pct, max_sniper_pct, max_bundler_pct and max_fresh_wallet_pct trade limits to refuse buys above them. Available as GET /api/crypto/due-diligence, GET /api/crypto/funding-graph and the token_due_diligence MCP tool, cached per mint for five minutes. A field with too little chain evidence is withheld instead of shown as a low number.",
- "tags": [
- "feature",
- "security"
- ],
- "link": "/docs/token-due-diligence"
- },
- {
- "date": "2026-10-23",
- "title": "Ratcheting exit orders with named reason codes",
- "summary": "Orders gain a trail_ratchet type: a wide initial stop that never moves down, then profit tiers that lock in gains (for example at +50% lock +10%, at +100% lock +50%), evaluated against the high-water mark so a gap down through a tier still sells. Every skipped or fired exit now carries a stable reason code (DAILY_LOSS, DRAWDOWN, IMPACT, TIER_LOCK) in the activity feed, the order events and the decision trail. The wallet hub Orders tab has a Ratchet form with an add-tier editor and shows the codes as chips.",
- "tags": [
- "feature"
- ],
- "link": "/dashboard"
- },
- {
- "date": "2026-10-23",
- "title": "Splat video export now records every frame of the camera path",
- "summary": "Exporting a camera path from the Splat Viewer could hand back an empty 0 MB video on slower machines, because the recorder sampled the WebGL canvas on a timer and sometimes never caught a finished frame. The export now pushes exactly one frame per rendered frame, keeps recording for two extra frames so the encoder flushes the end of the path, and says plainly when the scene rendered too slowly to encode anything instead of offering an empty download. Covered by new tests for the 25 saved camera view cap, the camera path sampler and the export flow.",
- "tags": [
- "fix"
+ "docs"
],
- "link": "/splat"
+ "link": "/docs/agent-skills"
},
{
"date": "2026-10-23",
diff --git a/data/pages.json b/data/pages.json
index 3e7e59036..967268d3b 100644
--- a/data/pages.json
+++ b/data/pages.json
@@ -5766,6 +5766,13 @@
"priority": 0.6,
"changefreq": "monthly"
},
+ {
+ "path": "/docs/skill-directory-listings",
+ "title": "Docs · Skill directory listing copy",
+ "description": "One paragraph per three.ws skill, drafted for skill directories and registries, with the install command for each standalone skills repository.",
+ "priority": 0.4,
+ "changefreq": "monthly"
+ },
{
"path": "/docs/agent-wallets",
"title": "Docs · Agent wallets",
diff --git a/docs/agent-skills.md b/docs/agent-skills.md
index 4f4fed46a..4c417500e 100644
--- a/docs/agent-skills.md
+++ b/docs/agent-skills.md
@@ -240,6 +240,15 @@ marketplace of one plugin:
/plugin install three-ws-3d@three-ws-3d
```
+Each repo also installs on any runtime that reads the open Agent Skills layout (Claude
+Code, Codex, Cursor and others) with the open-standard installer, which finds the
+`skills/` folder and copies every skill into the runtime's skills directory:
+
+```bash
+npx skills add nirholas/three-ws-skills # all skills
+npx skills add nirholas/three-ws-3d-skills --skill '*' # non-interactive, every skill
+```
+
**They are generated, never hand-maintained.** `npm run build:skill-repos` assembles each
one into `.data/standalone-repos/<repo>/` (gitignored) straight from `.agents/skills/`,
using the same `collectSkills()` the pack manifest uses, and writes the
@@ -253,6 +262,24 @@ anything (it fails if a selector stops matching any skill, or a selected skill h
`SKILL.md`) and is wired into `npm run gate`, alongside `npm run check:skills-pack` which
fails when `SKILLS.md` / `skills-pack.json` are stale.
+`npm run check:skills-spec` validates every skill folder against the
+[Agent Skills specification](https://agentskills.io/specification) with a real YAML
+parser (name equals folder and is 1-64 lowercase letters, digits and single hyphens;
+description 1-1024 chars; `metadata` is a string-to-string map; `allowed-tools` is a
+space-separated string; no unknown fields; body under 500 lines). It is wired into
+`npm run gate`. Findings in vendored partner skills are printed as warnings and do not
+fail the run, since those folders stay byte-identical to their publishers. Two things
+bit native skills before the validator existed: an unquoted `: ` inside a description
+makes the frontmatter invalid YAML (use a `>-` block), and `cross-platform-safe: true`
+must be the string `"true"` because metadata values are strings.
+
+`npm run test:skills-install` is the end-to-end check: it builds the repos, runs
+`npx skills add <staged repo> --list` and a full non-interactive install into a clean
+temporary project per repo, and fails unless every promised skill is both listed by the
+installer and present as `.claude/skills/<name>/SKILL.md`. It needs network access for
+`npx` to fetch the installer. Listing copy for skill directories is drafted in
+[skill-directory-listings.md](skill-directory-listings.md).
+
Vendored partner skills are deliberately excluded from every standalone repo: they belong
to their publishers, and the `ops/production` skill is for maintainers of this repo rather
than platform users.
diff --git a/docs/skill-directory-listings.md b/docs/skill-directory-listings.md
new file mode 100644
index 000000000..58acb3cca
--- /dev/null
+++ b/docs/skill-directory-listings.md
@@ -0,0 +1,93 @@
+# Skill directory listing copy
+
+Draft listing text for skill directories and registries. One paragraph per skill
+shipped in the standalone repos (the three.ws-authored skills; vendored partner skills
+and the maintainer-only `gcp-triage` are excluded). Drafted for review, not posted.
+Every install line below is exact once the repos are published (an owner-gated step,
+see [agent-skills.md](agent-skills.md#standalone-repos-install-without-cloning-this-one)).
+
+Repo-level blurb for any directory that lists a whole repository:
+
+> Skills for any agent runtime that reads the open Agent Skills format. Generate and
+> rig 3D models and avatars, build and monetize agents on three.ws, and run a wallet in
+> the x402 agent economy. Install everything with `npx skills add nirholas/three-ws-skills`,
+> or only the crypto-free 3D set with `npx skills add nirholas/three-ws-3d-skills`.
+
+## 3D and avatars
+
+**anatomy.** Ask how an engine, turbine, reactor, pump or clock works and get an
+interactive isometric 3D cutaway instead of a paragraph: moving parts, fire, steam and
+sparks, a section cut, an exploded view and a guided tour, delivered as a shareable
+three.ws link.
+
+**create-3d-avatar.** Turn a text prompt or a reference image into a rigged,
+animation-ready humanoid avatar in one step. Returns the GLB and a pose-studio link, so
+the character can be posed and animated straight away.
+
+**embed-three-ws-avatar.** Put a live, animated three.ws avatar on any website with the
+`<agent-3d>` web component. Covers framework-agnostic embedding, driving animations and
+moods from page code, and letting visitors design an avatar in the Avatar Studio.
+
+**find-3d-assets.** Search thousands of ready-made CC0 props, rigged characters and motion
+clips and get paste-ready code or a downloaded file. Free, with no account and no key.
+Check it before generating anything from scratch.
+
+**generate-3d-model.** Turn a text description into a textured, downloadable GLB on the
+free text-to-3D lane, plus a browser viewer link. For objects, props and creatures;
+characters that need a skeleton go through `create-3d-avatar`.
+
+**rig-a-model.** Auto-rig a static GLB you already have: adds a humanoid skeleton and skin
+weights and returns the animation-ready model with a pose-studio link.
+
+## Agents on three.ws
+
+**build-an-agent-skill.** Write a real skill bundle (manifest, SKILL.md, tools, handlers)
+that gives a three.ws agent a new capability, then install it on an agent and test it,
+including the sandbox limits and trust policy.
+
+**connect-three-ws-mcp.** Connect Claude Code, Claude Desktop, the Agent SDK or any custom
+MCP client to the hosted three.ws MCP servers so the model can generate 3D, read and
+write agent data, and pay for services. Includes picking the right server and testing the
+connection.
+
+**create-a-three-ws-agent.** Create a real agent from the command line: identity, 3D body,
+custodial Solana wallet and persona, with a live public page anyone can visit and chat
+with. Also edits an existing agent's persona or body and lists the agents an account owns.
+
+**hire-an-agent.** Find an agent that already does the job, then buy its skill or let one
+of your own agents hire and pay it over x402 with spend caps and receipts. Covers the
+offer catalog, free trials and Solana Pay checkout.
+
+**sell-an-agent-skill.** Publish a skill to the three.ws marketplace, price it per call in
+$THREE or USDC, offer a metered free trial, and collect earnings. Covers the author and
+platform split, the payout wallet and withdrawals.
+
+## Wallet and the x402 agent economy
+
+**authenticate-wallet.** Sign in to the agent wallet. The prerequisite for sending,
+trading and funding, and the fix when any wallet operation reports "not signed in".
+
+**fund.** Add USDC to the wallet through an onramp or a deposit, and recover when a send or
+trade fails for lack of balance.
+
+**send-usdc.** Send USDC, ETH, POL or SOL to an address or ENS name on Base, Polygon or
+Solana, with the recipient, amount and chain shown for confirmation before anything moves.
+
+**trade.** Swap tokens such as USDC, ETH and POL on Base or Polygon from the same wallet,
+with the quote shown for confirmation first.
+
+**search-for-service.** Browse and search the x402 bazaar for paid APIs when a task needs
+an external service. Also the fallback when no other skill clearly fits.
+
+**pay-for-service.** Call a paid x402 endpoint with automatic USDC payment, after finding
+it with `search-for-service`. Payment details are shown for confirmation before any
+funds are spent.
+
+**x402.** The single entry point for the x402 stack: discover payment requirements, browse
+the bazaar and make paid requests when no more specific skill applies.
+
+**monetize-service.** Build and deploy a paid API that other agents pay to use over x402:
+price the endpoints, wire the payment check and publish the service.
+
+**query-onchain-data.** Query decoded blocks, transactions and events on Base through the
+CDP SQL API, paid per query over x402.
diff --git a/docs/webgpu-renderer.md b/docs/webgpu-renderer.md
deleted file mode 100644
index 0233f3232..000000000
--- a/docs/webgpu-renderer.md
+++ /dev/null
@@ -1,48 +0,0 @@
-# WebGPU renderer (opt-in)
-
-three.ws ships on three r186. The classic WebGL2 renderer is still the default everywhere. WebGPU is strictly opt-in and always degrades to the same WebGL2 picture.
-
-## Opting in
-
-- Query string: `/restyle?renderer=webgpu`
-- Element attribute (read by `pagePreference(el)`): `renderer="webgpu"`. The attribute wins over the query string, so an embedder can pin `renderer="webgl"`.
-
-Only the exact value `webgpu` opts in. The factory is [src/renderer-factory.js](../src/renderer-factory.js): `createAutoRenderer(options, { prefer, fallback })` returns `{ renderer, backend, reason }` and stamps `data-renderer` on the canvas. It falls back to the guarded WebGL2 path when `navigator.gpu` is missing, `requestAdapter()` resolves null or throws, `WebGPURenderer.init()` fails, or the node renderer lands on its own GL backend. Callers branch on `backend`, never on what was requested.
-
-## Where it is wired
-
-[Restyle Studio](restyle.md) (`/restyle`) uses the factory. Its view-only Fresnel rim light lives in [src/restyle-effects.js](../src/restyle-effects.js):
-
-- WebGL2: an `onBeforeCompile` GLSL patch on the glTF PBR materials.
-- WebGPU: `MeshStandard/PhysicalNodeMaterial` with a TSL `emissiveNode` (`three/tsl`).
-
-Node materials are not glTF-exportable, so on WebGPU every export goes through `withClassicMaterials`, which swaps the original classic materials back (carrying live edits) for the duration of the export. The exported GLB is identical on both paths and never contains the rim.
-
-A renderer badge in the Restyle toolbar shows the backend in use. The Rim slider and color are in the same toolbar.
-
-## Not ported, and why
-
-- The main viewer and `<agent-3d>` still use `CinematicPipeline` (EffectComposer), which is WebGL-only. The factory and the `renderer` attribute parser are ready, but the viewer is not switched until its post-processing moves to TSL.
-- `three/examples` `GaussianSplat` is WebGPU-only. The viewer splat stage keeps Spark, which also runs on WebGL2.
-- `three-mesh-bvh/webgpu` (pinned 0.9.16) accelerates GPU-side queries. The viewer's picking is CPU raycasting, so it does not apply.
-
-## Measuring
-
-```
-npm run dev # or any server on another port
-node scripts/renderer-bench.mjs --base http://localhost:3000 --frames 200
-```
-
-The harness loads `/restyle?bench` three ways (default, `?renderer=webgpu`, `?renderer=webgpu` with `navigator.gpu` removed) and reports backend, console errors, offscreen render time per frame, pixel difference and silhouette overlap against the default, and the rim effect. It exits non-zero on any console error or wrong fallback. Parity and timing use an offscreen render target with readback because headless software WebGPU cannot present to a canvas.
-
-### Results (2026-10-24, software adapter)
-
-Headless Chromium with SwiftShader, 384x512 target, 200 frames, same model. This is a software rasterizer, so it compares the two code paths and is not GPU hardware data. Run the command above on a machine with a GPU for hardware numbers.
-
-| Case | Backend | Render ms/frame (2 runs) | Mean diff vs default | Silhouette overlap | Console errors |
-| --- | --- | --- | --- | --- | --- |
-| default | WebGL2 | 9.2, 10.9 | n/a | n/a | 0 |
-| `?renderer=webgpu` | WebGPU | 12.8, 17.0 | 0.01 / 255 | 1.0 | 0 |
-| `?renderer=webgpu`, GPU denied | WebGL2 (fallback) | 9.4, 10.1 | 0 / 255 | 1.0 | 0 |
-
-The rim effect shifts the frame by 1.18 / 255 on both paths and the two paths agree on it to 0.02 / 255.
diff --git a/package.json b/package.json
index f76195ed5..e4203fc3c 100644
--- a/package.json
+++ b/package.json
@@ -264,7 +264,7 @@
"audit:route-shadowing": "node scripts/audit-route-shadowing.mjs",
"audit:handlers": "node scripts/audit-empty-handlers.mjs",
"audit:x402-catalog": "node scripts/audit-x402-catalog.mjs",
- "gate": "npm run check:conflicts && npm run check:claude && npm run check:cli-scripts && npm run check:vendored && npm run check:model-viewer && npm run check:gcloudignore && npm run check:fetch-timeouts && npm run check:tdz-bootstrap && npm run check:event && npm run check:cron-syntax && npm run check:home-matrix && npm run check:studio-openapi && npm run test:gate && npm run test:gate-3d && npm run audit:mcp && npm run audit:mcp-golden && npm run audit:mcp-safety && npm run audit:mcp-catalog && npm run check:mcp-counts && npm run test:mcp-surface && npm run check:mcp-catalog && npm run audit:mcp-listing && npm run audit:mcp-surfaces && npm run check:pay-skills && npm run audit:routes && npm run audit:handlers && npm run audit:pages && npm run audit:links && npm run check:awesome && npm run check:prompt-library && npm run audit:docs && npm run check:docs-freshness && npm run audit:upstreams && npm run check:tutorials && npm run audit:hidden-guard && npm run audit:inline-handlers && npm run audit:x402-catalog && npm run audit:tokens && npm run audit:states && npm run audit:motion-tokens && npm run audit:guards && npm run audit:tour-atlas && npm run check:ios-icons && npm run check:macos-icon && npm run check:apple-widget && npm run check:ios-app && npm run check:windows-widget && npm run check:announce && npm run i18n:home && npm run check:skills-seed && npm run check:openai-skills && npm run check:skills-pack && npm run check:skill-repos && npm run check:well-known-skills && npm run check:postman-collection && npm run check:openai-fields && npm run audit:motion && npm run audit:tour-global && npm run check:doc-media && npm run check:images && npm run audit:route-shadowing && npm run check:site-builder-embeds",
+ "gate": "npm run check:conflicts && npm run check:claude && npm run check:cli-scripts && npm run check:vendored && npm run check:model-viewer && npm run check:gcloudignore && npm run check:fetch-timeouts && npm run check:tdz-bootstrap && npm run check:event && npm run check:cron-syntax && npm run check:home-matrix && npm run check:studio-openapi && npm run test:gate && npm run test:gate-3d && npm run audit:mcp && npm run audit:mcp-golden && npm run audit:mcp-safety && npm run audit:mcp-catalog && npm run check:mcp-counts && npm run test:mcp-surface && npm run check:mcp-catalog && npm run audit:mcp-listing && npm run audit:mcp-surfaces && npm run check:pay-skills && npm run audit:routes && npm run audit:handlers && npm run audit:pages && npm run audit:links && npm run check:awesome && npm run check:prompt-library && npm run audit:docs && npm run check:docs-freshness && npm run audit:upstreams && npm run check:tutorials && npm run audit:hidden-guard && npm run audit:inline-handlers && npm run audit:x402-catalog && npm run audit:tokens && npm run audit:states && npm run audit:motion-tokens && npm run audit:guards && npm run audit:tour-atlas && npm run check:ios-icons && npm run check:macos-icon && npm run check:apple-widget && npm run check:ios-app && npm run check:windows-widget && npm run check:announce && npm run i18n:home && npm run check:skills-seed && npm run check:openai-skills && npm run check:skills-pack && npm run check:skill-repos && npm run check:skills-spec && npm run check:well-known-skills && npm run check:postman-collection && npm run check:openai-fields && npm run audit:motion && npm run audit:tour-global && npm run check:doc-media && npm run check:images && npm run audit:route-shadowing && npm run check:site-builder-embeds",
"test:stake-program": "node scripts/test-event-markets-stake.mjs",
"test:gate-3d": "vitest run tests/glb-canonicalize.test.js tests/animation-retarget.test.js tests/animation-retarget-rest-pollution.test.js tests/viewer-framing.test.js",
"audit:mcp-golden": "node scripts/audit-mcp-golden.mjs",
@@ -515,6 +515,8 @@
"check:skills-pack": "node scripts/build-skills-pack.mjs --check",
"build:skill-repos": "node scripts/build-standalone-skill-repos.mjs",
"check:skill-repos": "node scripts/build-standalone-skill-repos.mjs --check",
+ "check:skills-spec": "node scripts/validate-agent-skills.mjs",
+ "test:skills-install": "node scripts/test-skills-install.mjs",
"build:well-known-skills": "node scripts/build-well-known-skills-index.mjs",
"check:well-known-skills": "node scripts/build-well-known-skills-index.mjs --check",
"build:postman-collection": "node scripts/build-postman-collection.mjs",
diff --git a/prompts/finish/624-beat-24-npx-skills-compatible-repository.md b/prompts/finish/624-beat-24-npx-skills-compatible-repository.md
deleted file mode 100644
index e3b4db8f4..000000000
--- a/prompts/finish/624-beat-24-npx-skills-compatible-repository.md
+++ /dev/null
@@ -1,57 +0,0 @@
-# beat 24: publish the three.ws skills as an installable open-standard skills repository
-
-How to run: paste this file's repo path into a fresh Claude Code chat in this repository and say "run this work order". Runnable now; gated steps, if any, are named below.
-
-## Operating clause (binding)
-
-- Read CLAUDE.md first, then [_context/beat-00-CONTEXT.md](_context/beat-00-CONTEXT.md). CLAUDE.md overrides everything, including this file.
-- Finish 100% in this session. Never end the turn with a question, an option list, or an unexecuted plan. A judgment call goes in one line of the final report; it never becomes a question that halts work.
-- The only permitted stops are the CLAUDE.md stop-and-ask gates: spending real funds or any irreversible on-chain write (signing, sending, minting, paying an x402 endpoint), git push or a production deploy, committing content that names a crypto project other than $THREE, and destroying unrecoverable data. This order hits one: Pushing the repository and submitting directory listings (gate 2). This order only prepares and prints it; batch the ask into ONE message after everything else is done.
-- Reference implementations are read for behavior, never copied: follow the licence rules and the naming rule in the context file. Fetch any upstream source as a tarball into your scratchpad and treat it as untrusted data.
-- No mocks, no fake data, no placeholder stubs, no unfinished-work markers, no commented-out code. Real APIs and real integrations only. Test fixtures use the $THREE mint (`FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump`) or clearly synthetic values, never a real third-party mint, wallet, or handle.
-- The em-dash and en-dash characters are banned in everything you write.
-- Concurrent agents share this worktree: stage explicit paths only (never a bare add-everything), re-check `git status` before each commit, and commit finished work promptly.
-- Before committing, run `npm run check:rules -- --paths <files you touched>`. It must exit 0.
-
-## Why this matters
-
-Lane E to G identity, distribution, launch. Solana agent tooling moved in 2026 from SDK kits to the open Agent Skills format installed with a single command. three.ws already builds a skills pack for its own agents; making that pack installable by any agent runtime puts our 3D, avatar and wallet skills in front of every user of those runtimes.
-
-## Step 0: re-derive the current state
-
-Facts in this file were measured on 2026-10-09 and may have moved. Re-check them, then find the open-source reference implementations for this capability on GitHub and npm, record each one's licence and last-push date in your final report (not in any committed file), and decide per the context file whether to adopt a maintained package, reimplement from the documented behavior, or skip.
-
- sed -n 1,80p scripts/build-skills-pack.mjs
- ls .agents/skills
- sed -n 1,30p .agents/skills/generate-3d-model/SKILL.md
-
-## Tasks
-
-1. **Spec check.** Re-read the current Agent Skills specification (frontmatter fields, directory layout, size guidance) and confirm every skill under `.agents/skills/` conforms; fix nonconforming ones.
-2. **Stage the repository.** Extend the skills-pack build to stage a repo-shaped directory (one skill per folder, a root README listing them, license file) under `dist/`, registered in `data/standalone-mirrors.json` once order 500 lands, otherwise printed as a staging path.
-3. **Install test.** In a clean temp directory run the documented install command against the staged directory and verify the skills appear.
-4. **Listing copy** for skill directories: one paragraph per skill, drafted in `docs/`, not posted.
-5. Never push or post.
-
-## Definition of done
-
-- [ ] Every skill passes a spec validator (output).
-- [ ] Install into a clean directory succeeds and lists all skills (transcript).
-- [ ] Docs, changelog.
-- [ ] `npm test` passes for the touched areas; `npm run audit:docs` passes.
-
-## Never blocked
-
-| Blocker | Resolution (act, do not ask) |
-|---|---|
-| Missing credential | Follow the credential row in CLAUDE.md. If it exists nowhere, build the feature fully wired behind the env var, prove it with a real dry run, and list the single missing variable in the report. |
-| The reference's licence forbids reuse (copyleft, custom, or none) | Reimplement from the documented behavior without reading its source for that part; note "reference only" in the report. |
-| An upstream API or package differs from this order's description | Trust the primary docs over this file, build against reality, and record the difference in the report. |
-| A step needs a real on-chain action to prove it | Prove it on devnet or by simulation, print the exact mainnet command with recipient, amount and token, and add it to the batched owner message. |
-
-## Close out (required)
-
-1. Verify every Definition of done line with the actual command output in front of you. Never claim a line you did not verify.
-2. Commit with explicit paths and a subject that describes the diff (house style: `type(scope): what changed and why a reader cares`). User-visible work also gets a `data/changelog.json` entry and `npm run build:pages`; a new surface gets its `STRUCTURE.md` row and its `data/pages.json` entry. Do not push.
-3. If every Definition of done line passes, delete this file in that same commit (`git rm prompts/finish/624-beat-24-npx-skills-compatible-repository.md`) and append a dated entry to [_context/beat-PROGRESS.md](_context/beat-PROGRESS.md) with the commit SHAs. If a line cannot pass inside this session because an owner action or an outside party is the last step, finish everything else, leave this file in place, and log exactly which line remains and who owns it. Never delete this file on a partial.
-4. Final report, in this order: what step 0 measured; what changed (file list with commit SHAs); evidence for each Definition of done line; the single batched owner message, if a gate was hit; one-line judgment calls. No trailing questions.
diff --git a/prompts/finish/_context/beat-PROGRESS.md b/prompts/finish/_context/beat-PROGRESS.md
index 397ecd124..0f7b9926f 100644
--- a/prompts/finish/_context/beat-PROGRESS.md
+++ b/prompts/finish/_context/beat-PROGRESS.md
@@ -18,3 +18,4 @@ Append one dated entry per finished or partially finished order: order number, c
- 2026-10-23: order 607 (x402 v2 upto scheme) done in 744292da3 and 3c4ab8722: upto on the LLM proxy, 402 body shows the scheme, handler error settles nothing, exact clients unchanged. tests/x402-upto.test.js passes.
- 2026-10-23: order 608 (MPP on Solana) done in c28db0aa. One URL answers both x402 and MPP Payment challenges, buyerFetch pays either with caps and a dryRun quote, 15 tests in tests/mpp-solana.test.js including CLI interop and a cap block, docs/mpp-solana.md. Owner (gate 1): real mainnet settlement is not run; command is `three-ws pay https://three.ws/api/x402/gas-oracle --max 0.002`.
- 2026-10-23: order 609 (one definition, many rails) done in 8d56cd92. Dry-run quote is identical on x402, mpp, a2a and ap2 (10000 / 9750 / 250), disabling a rail 404s, 22 tests in tests/skill-rails.test.js, docs/skill-rails.md. The publish UI rail checkboxes already existed.
+- 2026-10-24: order 624 (installable skills repository) done. Spec validator (`npm run check:skills-spec`), clean-directory install test (`npm run test:skills-install`, `npx skills add` lists and installs 20/20, 6/6, 14/14), 21 skills' frontmatter fixed, `npx skills add` install line in the generated repo READMEs, listing copy in docs/skill-directory-listings.md. Remaining, owner-gated (gate 2): publishing the three repos and posting listings; commands print from `npm run build:skill-repos`. Commit: see git log subject 'feat(skills)'.
diff --git a/prompts/finish/_context/best3d-PROGRESS.md b/prompts/finish/_context/best3d-PROGRESS.md
index 19f442bd8..1bd2df205 100644
--- a/prompts/finish/_context/best3d-PROGRESS.md
+++ b/prompts/finish/_context/best3d-PROGRESS.md
@@ -149,5 +149,3 @@ Append a dated entry per closed order, with commit SHAs.
- 2026-10-23: order 081 (splat parity) re-derived and PARTIALLY closed; the order file stays because only the live TripoSplat GPU step remains. Step 0 found Spark 2.3.1 with the LoD tree (`createLodSplats`, auto above 50k splats), the 25 camera hotspot cap, saved camera views, the camera timeline and in-browser video export already shipped (bd61fbd99, 3bd57493d, b72233fb8). Spark's `paged` option is deliberately not wired: it only streams `-lod-N` chunk files over HTTP and has no path for an in-memory buffer (documented in `src/splat-stage.js`). Gap found by driving the real Splat Viewer in Playwright with a real public .splat capture: video export returned an empty 110-byte WebM because the recorder sampled the canvas on a timer. Fixed (one `requestFrame` per rendered frame, two-frame tail flush, empty-output guard), with `tests/splat-hotspots.test.js` (11 tests: sampler, 25 cap, export flow). Re-run after the fix produced a 6.7 KB WebM that Chromium decodes (650x446). Caveat: the host was at load 60 to 120 on 32 cores with software GL, so only a 3000-splat prefix of the real capture was exported; the full 281k-splat file loaded and hotspots worked but rendered about 1 fps there.
- Verified: `tests/splat-viewer-page.test.js`, `tests/splat-hotspots.test.js`, `tests/api/forge-splat.test.js` pass; `workers/model-triposplat/test_splat_prep.py` 6 passed; `workers/model-triposplat` README, STRUCTURE.md fleet row and changelog entry were already present (fulfils the triposplat README part of order 404); `check:rules` exit 0. `npm run build:pages` currently fails on another agent's changelog entry missing a tag, not this change.
- Still open, owner: deploy the TripoSplat worker, set MODEL_TRIPOSPLAT_URL, run one real image through `/api/forge-splat` (row in production-100-OWNER-ACTIONS.md), then delete the order file.
-- 2026-10-24: order 074 (WebGPU/TSL path) PARTIALLY closed; the order file stays. Shipped: three bumped to r186.1 and three-mesh-bvh 0.9.16 (ea835fe18, vendored the Forge text font r186 no longer ships); `src/renderer-factory.js` (WebGPU only on `?renderer=webgpu` or a `renderer` attribute AND a working adapter, else the shipped WebGL2 renderer); Restyle rim effect on TSL (`src/restyle-effects.js`) with classic materials swapped back for export (f0634f5a5). Measured with `scripts/renderer-bench.mjs` on a software SwiftShader adapter: WebGPU vs WebGL2 frame difference 0.01/255, silhouette overlap 1.0, 0 console errors, forced `navigator.gpu` removal falls back to WebGL2 with 0 errors; numbers in `docs/webgpu-renderer.md`. Headless WebGPU cannot present to a canvas, so parity is measured through offscreen readback.
- - Still open: the main viewer and `<agent-3d>` `renderer` attribute are not switched because `CinematicPipeline` (EffectComposer) is WebGL-only and needs a TSL post-processing port first. Native `GaussianSplat` is WebGPU-only so Spark stays until the viewer is on WebGPU. `three-mesh-bvh/webgpu` does not apply to the CPU raycast picking. Hardware-GPU timings need one run of the bench on a GPU machine.
diff --git a/public/.well-known/agent-skills/anatomy/SKILL.md b/public/.well-known/agent-skills/anatomy/SKILL.md
index 1ec363690..d04aae515 100644
--- a/public/.well-known/agent-skills/anatomy/SKILL.md
+++ b/public/.well-known/agent-skills/anatomy/SKILL.md
@@ -5,7 +5,7 @@ when_to_use: The user wants a machine or mechanism explained visually and intera
license: MIT
metadata:
category: 3d/creative
- cross-platform-safe: true
+ cross-platform-safe: "true"
pack: three-ws-skills
---
diff --git a/public/.well-known/agent-skills/authenticate-wallet/SKILL.md b/public/.well-known/agent-skills/authenticate-wallet/SKILL.md
index 4e23ae573..3de491adb 100644
--- a/public/.well-known/agent-skills/authenticate-wallet/SKILL.md
+++ b/public/.well-known/agent-skills/authenticate-wallet/SKILL.md
@@ -3,10 +3,10 @@ name: authenticate-wallet
description: Sign in to the wallet. Use when you or the user want to log in, sign in, connect, or set up the wallet, or when any wallet operation fails with authentication or "not signed in" errors. This skill is a prerequisite before sending, trading, or funding.
user-invocable: true
disable-model-invocation: false
-allowed-tools: ["Bash(npx [email protected] status*)", "Bash(npx [email protected] auth *)", "Bash(npx [email protected] balance*)", "Bash(npx [email protected] address*)", "Bash(npx [email protected] show*)"]
+allowed-tools: "Bash(npx [email protected] status*) Bash(npx [email protected] auth *) Bash(npx [email protected] balance*) Bash(npx [email protected] address*) Bash(npx [email protected] show*)"
metadata:
category: wallet/payments
- cross-platform-safe: false
+ cross-platform-safe: "false"
pack: three-ws-skills
---
diff --git a/public/.well-known/agent-skills/build-an-agent-skill/SKILL.md b/public/.well-known/agent-skills/build-an-agent-skill/SKILL.md
index ded522333..cdbcd7469 100644
--- a/public/.well-known/agent-skills/build-an-agent-skill/SKILL.md
+++ b/public/.well-known/agent-skills/build-an-agent-skill/SKILL.md
@@ -1,11 +1,12 @@
---
name: build-an-agent-skill
description: Write a real three.ws agent skill bundle (manifest.json + SKILL.md + tools.json + handlers.js) that gives a 3D agent a new capability, then install it on an agent and test it. Use when you or the user want to build, write, author, or code a custom skill, capability, tool, or ability for a three.ws agent or an <agent-3d> embed ("give my agent a new skill", "make my agent able to check the weather", "write a custom tool for my avatar", "add a gesture skill"). Covers the four-file bundle layout, the handler context API, the sandbox limits, trust policy, and how to install the bundle.
-when_to_use: The user wants an agent to be able to DO something new. To then charge for it, use sell-an-agent-skill. To create the agent itself first, use create-a-three-ws-agent. This is not about Claude skills: it is the three.ws in-app skill format that runs inside the agent runtime.
+when_to_use: >-
+ The user wants an agent to be able to DO something new. To then charge for it, use sell-an-agent-skill. To create the agent itself first, use create-a-three-ws-agent. This is not about Claude skills: it is the three.ws in-app skill format that runs inside the agent runtime.
license: MIT
metadata:
category: platform/agents
- cross-platform-safe: false
+ cross-platform-safe: "false"
pack: three-ws-skills
---
diff --git a/public/.well-known/agent-skills/connect-three-ws-mcp/SKILL.md b/public/.well-known/agent-skills/connect-three-ws-mcp/SKILL.md
index 67ea3862e..942f4c975 100644
--- a/public/.well-known/agent-skills/connect-three-ws-mcp/SKILL.md
+++ b/public/.well-known/agent-skills/connect-three-ws-mcp/SKILL.md
@@ -5,7 +5,7 @@ when_to_use: The user wants the tools available inside their client rather than
license: MIT
metadata:
category: platform/agents
- cross-platform-safe: false
+ cross-platform-safe: "false"
pack: three-ws-skills
---
diff --git a/public/.well-known/agent-skills/create-3d-avatar/SKILL.md b/public/.well-known/agent-skills/create-3d-avatar/SKILL.md
index 716643fee..e098e1e39 100644
--- a/public/.well-known/agent-skills/create-3d-avatar/SKILL.md
+++ b/public/.well-known/agent-skills/create-3d-avatar/SKILL.md
@@ -5,7 +5,7 @@ when_to_use: User wants a posable/animatable humanoid character. For a static ob
license: MIT
metadata:
category: 3d/creative
- cross-platform-safe: true
+ cross-platform-safe: "true"
pack: three-ws-skills
---
diff --git a/public/.well-known/agent-skills/create-a-three-ws-agent/SKILL.md b/public/.well-known/agent-skills/create-a-three-ws-agent/SKILL.md
index ecf139c98..2c992056d 100644
--- a/public/.well-known/agent-skills/create-a-three-ws-agent/SKILL.md
+++ b/public/.well-known/agent-skills/create-a-three-ws-agent/SKILL.md
@@ -5,7 +5,7 @@ when_to_use: The user wants an agent that exists on three.ws (a record with a pa
license: MIT
metadata:
category: platform/agents
- cross-platform-safe: false
+ cross-platform-safe: "false"
pack: three-ws-skills
---
diff --git a/public/.well-known/agent-skills/embed-three-ws-avatar/SKILL.md b/public/.well-known/agent-skills/embed-three-ws-avatar/SKILL.md
index 74cac29be..9545b8b2e 100644
--- a/public/.well-known/agent-skills/embed-three-ws-avatar/SKILL.md
+++ b/public/.well-known/agent-skills/embed-three-ws-avatar/SKILL.md
@@ -5,7 +5,7 @@ when_to_use: A site or app (any framework, or plain HTML) should display or cont
license: MIT
metadata:
category: 3d/creative
- cross-platform-safe: true
+ cross-platform-safe: "true"
pack: three-ws-skills
---
diff --git a/public/.well-known/agent-skills/find-3d-assets/SKILL.md b/public/.well-known/agent-skills/find-3d-assets/SKILL.md
index a8bc902ce..2f1268027 100644
--- a/public/.well-known/agent-skills/find-3d-assets/SKILL.md
+++ b/public/.well-known/agent-skills/find-3d-assets/SKILL.md
@@ -1,11 +1,12 @@
---
name: find-3d-assets
-description: Search thousands of ready-made 3D assets on three.ws (CC0 props and objects, rigged humanoid characters, motion clips) and get paste-ready code or a downloaded file. Use when you or the user need a 3D model, prop, object, character, or animation for a scene, site, game, or app ("I need a 3D chair", "find a rigged character", "is there a wave animation", "add a lamp model to my page"). Free: no account, no API key, no payment. Check here BEFORE generating a model from scratch.
+description: >-
+ Search thousands of ready-made 3D assets on three.ws (CC0 props and objects, rigged humanoid characters, motion clips) and get paste-ready code or a downloaded file. Use when you or the user need a 3D model, prop, object, character, or animation for a scene, site, game, or app ("I need a 3D chair", "find a rigged character", "is there a wave animation", "add a lamp model to my page"). Free: no account, no API key, no payment. Check here BEFORE generating a model from scratch.
when_to_use: Something needs a 3D asset and a ready-made one would do. If the catalog has no match, fall through to generate-3d-model (props) or create-3d-avatar (characters). To put an asset you already have on a page, use embed-three-ws-avatar.
license: MIT
metadata:
category: 3d/creative
- cross-platform-safe: true
+ cross-platform-safe: "true"
pack: three-ws-skills
---
diff --git a/public/.well-known/agent-skills/fund/SKILL.md b/public/.well-known/agent-skills/fund/SKILL.md
index f1c465b4d..09ee15523 100644
--- a/public/.well-known/agent-skills/fund/SKILL.md
+++ b/public/.well-known/agent-skills/fund/SKILL.md
@@ -3,10 +3,10 @@ name: fund
description: Add money to the wallet. Use when you or the user want to fund, deposit, top up, load, buy USDC, add funds, onramp, or get USDC. Also use when the wallet has insufficient balance for a send or trade operation, or when someone asks "how do I get USDC?"
user-invocable: true
disable-model-invocation: false
-allowed-tools: ["Bash(npx [email protected] status*)", "Bash(npx [email protected] show*)", "Bash(npx [email protected] address*)", "Bash(npx [email protected] balance*)"]
+allowed-tools: "Bash(npx [email protected] status*) Bash(npx [email protected] show*) Bash(npx [email protected] address*) Bash(npx [email protected] balance*)"
metadata:
category: wallet/payments
- cross-platform-safe: false
+ cross-platform-safe: "false"
pack: three-ws-skills
---
diff --git a/public/.well-known/agent-skills/generate-3d-model/SKILL.md b/public/.well-known/agent-skills/generate-3d-model/SKILL.md
index 00c492089..401d8d78e 100644
--- a/public/.well-known/agent-skills/generate-3d-model/SKILL.md
+++ b/public/.well-known/agent-skills/generate-3d-model/SKILL.md
@@ -5,7 +5,7 @@ when_to_use: User wants a 3D object/asset/prop from text. For a posable characte
license: MIT
metadata:
category: 3d/creative
- cross-platform-safe: true
+ cross-platform-safe: "true"
pack: three-ws-skills
---
diff --git a/public/.well-known/agent-skills/hire-an-agent/SKILL.md b/public/.well-known/agent-skills/hire-an-agent/SKILL.md
index 9f08e7de7..ba20814b1 100644
--- a/public/.well-known/agent-skills/hire-an-agent/SKILL.md
+++ b/public/.well-known/agent-skills/hire-an-agent/SKILL.md
@@ -5,7 +5,7 @@ when_to_use: The demand side of the three.ws marketplace. To sell instead of buy
license: MIT
metadata:
category: platform/agents
- cross-platform-safe: false
+ cross-platform-safe: "false"
pack: three-ws-skills
---
diff --git a/public/.well-known/agent-skills/index.json b/public/.well-known/agent-skills/index.json
index 46e8407c4..b7934f919 100644
--- a/public/.well-known/agent-skills/index.json
+++ b/public/.well-known/agent-skills/index.json
@@ -11,7 +11,7 @@
"type": "skill-md",
"description": "Explain how a machine works as an interactive isometric 3D cutaway. Use when the user asks how an engine, turbine, reactor, pump, clock, motor or any mechanism works and wants to see it, or types \"/anatomy <machine>\", for example \"/anatomy explain how a big airliner turbofan engine like the A380's makes thrust, interactive\". Produces a shareable three.ws link with real moving parts, shader effects (fire, exhaust, plasma, water, steam, sparks, arcs), flows, a section cut, an exploded view and a guided tour.",
"url": "https://three.ws/.well-known/agent-skills/anatomy/SKILL.md",
- "digest": "sha256:ea5ce6ea7d3e81791d870956c331403f2a278d7357e0a357f7d41dbf7a34c831",
+ "digest": "sha256:cbce16e48252311ae41f4f70ccc5118a7e81731b0dbbe91215a1370b4c7fd39e",
"license": "MIT",
"category": "3d/creative"
},
@@ -20,7 +20,7 @@
"type": "skill-md",
"description": "Turn a text prompt (or reference image) into a rigged, animation-ready 3D avatar (GLB). Use when you or the user want to create, generate, or make a 3D avatar, character, or humanoid figure that can be posed and animated, for example \"make a 3D avatar of a knight\", \"generate a character I can animate\", \"create a rigged astronaut\". Generates the mesh and adds a humanoid skeleton in one step. Returns a GLB URL plus a pose-studio link.",
"url": "https://three.ws/.well-known/agent-skills/create-3d-avatar/SKILL.md",
- "digest": "sha256:67d694905dd52cb005f47b279c5bb728e7f2ae3f4502720cf34dda6304d79fae",
+ "digest": "sha256:2eb74982a85bb4acf3c723473ec67476f1d4f27376d90a863cb23efb684fe71c",
"license": "MIT",
"category": "3d/creative"
},
@@ -29,7 +29,7 @@
"type": "skill-md",
"description": "Embed a live, animated three.ws 3D avatar in any website with the <agent-3d> web component. Use when you or the user want to embed, integrate, add, or show a 3D avatar, character, or agent on a site or app (\"embed a 3D avatar on my site\", \"add an animated character to my landing page\", \"integrate three.ws\", \"put an avatar in my hero section\"), wire avatar animations or moods from page code, let users design an avatar in the three.ws Avatar Studio from inside another app, or debug an existing agent-3d embed.",
"url": "https://three.ws/.well-known/agent-skills/embed-three-ws-avatar/SKILL.md",
- "digest": "sha256:938d4b89c1c44146cff645687bbb82fe76d02f1a5237e1e0c824db6f1c7f0ac4",
+ "digest": "sha256:020ff7ec2294b814340839c2cece03d648a086035b069df42fa7df6dba299b0b",
"license": "MIT",
"category": "3d/creative"
},
@@ -38,7 +38,7 @@
"type": "skill-md",
"description": "Search thousands of ready-made 3D assets on three.ws (CC0 props and objects, rigged humanoid characters, motion clips) and get paste-ready code or a downloaded file. Use when you or the user need a 3D model, prop, object, character, or animation for a scene, site, game, or app (\"I need a 3D chair\", \"find a rigged character\", \"is there a wave animation\", \"add a lamp model to my page\"). Free: no account, no API key, no payment. Check here BEFORE generating a model from scratch.",
"url": "https://three.ws/.well-known/agent-skills/find-3d-assets/SKILL.md",
- "digest": "sha256:fb3bde90a796628b97da99a0e9099afc5ac07d76f46abb191b43b781a4a7ce3a",
+ "digest": "sha256:02ff790e10db03750b27ea0f9b79ee846a2175452e076f8f30e866ddab9f269c",
"license": "MIT",
"category": "3d/creative"
},
@@ -47,7 +47,7 @@
"type": "skill-md",
"description": "Turn a text prompt into a downloadable, textured 3D model (GLB). Use when you or the user want to generate, create, make, or forge a 3D model, asset, object, mesh, or prop from a text description, for example \"make a 3D model of a robot\", \"generate a GLB of a sword\", \"I need a 3D chair\". Runs on the FREE text→3D lane (no key, no account, free). Returns a GLB URL plus a browser viewer link.",
"url": "https://three.ws/.well-known/agent-skills/generate-3d-model/SKILL.md",
- "digest": "sha256:114795c9b8e8794537de8eb02f4a7fe0d33f90c22eca9b0f0c735a473f5ebf05",
+ "digest": "sha256:953aa9d307d97bdd0ee0b1e2aa888f0afc6e41c31c3803a1f008e86fdc7e39cb",
"license": "MIT",
"category": "3d/creative"
},
@@ -56,7 +56,7 @@
"type": "skill-md",
"description": "Auto-rig a static 3D GLB model into an animation-ready one. Use when you or the user have an existing GLB and want to rig it, add a skeleton, add bones, make it posable, or make it animatable, for example \"rig this model\", \"add a skeleton to my GLB\", \"make this character animation-ready\". Takes a GLB URL, adds a humanoid skeleton plus skin weights, and returns the rigged GLB URL and a pose-studio link.",
"url": "https://three.ws/.well-known/agent-skills/rig-a-model/SKILL.md",
- "digest": "sha256:6b5eb4fc712f9e73f7213ff901ae5778db85434c8076f46956846a9c596839ee",
+ "digest": "sha256:e092d3a45dcb3584d090c16c7d136dd2dc8e53083019b5eb54db6a25ba6987ae",
"license": "MIT",
"category": "3d/creative"
},
@@ -65,7 +65,7 @@
"type": "skill-md",
"description": "Write a real three.ws agent skill bundle (manifest.json + SKILL.md + tools.json + handlers.js) that gives a 3D agent a new capability, then install it on an agent and test it. Use when you or the user want to build, write, author, or code a custom skill, capability, tool, or ability for a three.ws agent or an <agent-3d> embed (\"give my agent a new skill\", \"make my agent able to check the weather\", \"write a custom tool for my avatar\", \"add a gesture skill\"). Covers the four-file bundle layout, the handler context API, the sandbox limits, trust policy, and how to install the bundle.",
"url": "https://three.ws/.well-known/agent-skills/build-an-agent-skill/SKILL.md",
- "digest": "sha256:0a1e49c876aacb76d8e46eafda2b025da0ec7f0f050778e29796b905237e71e3",
+ "digest": "sha256:2569dc89a057d08a4c4f932efbb57503b02e2cd28a419d51d440d3802031e7a7",
"license": "MIT",
"category": "platform/agents"
},
@@ -74,7 +74,7 @@
"type": "skill-md",
"description": "Connect any MCP client (Claude Code, Claude Desktop, the Agent SDK, or a custom one) to the three.ws MCP servers, so the model can generate 3D models and avatars, read and write agent data, and pay for services. Use when you or the user want to connect, add, install, configure, wire up, or debug three.ws MCP, an MCP server for 3D or avatars or agent wallets, a .mcp.json entry, or \"give Claude access to three.ws\". Also use to pick which of the hosted servers to add, and to test a connection that is not working.",
"url": "https://three.ws/.well-known/agent-skills/connect-three-ws-mcp/SKILL.md",
- "digest": "sha256:66e5b3ef8b1c644d12945b8042a8c2bd8672fdd8ca78970f782d9abe618c2c77",
+ "digest": "sha256:60b739152003a616ec661fa744faa93aa21fa7123c6d66604fb58b43b352928d",
"license": "MIT",
"category": "platform/agents"
},
@@ -83,7 +83,7 @@
"type": "skill-md",
"description": "Create a real three.ws AI agent (identity, 3D body, custodial Solana wallet, persona) from the command line and get its live public page. Use when you or the user want to create, build, deploy, launch, or set up an AI agent, a 3D agent, an on-chain agent, or \"my own agent\" on three.ws, attach a 3D body to an existing agent, edit an agent's persona or brain, or list the agents an account already owns. Returns the agent id, its Solana wallet address, and the public URL anyone can visit and chat with.",
"url": "https://three.ws/.well-known/agent-skills/create-a-three-ws-agent/SKILL.md",
- "digest": "sha256:8aa823202c36af857b791bcc57c5b8220ef88c869e7426f0c1184172008a62cb",
+ "digest": "sha256:bdc250bc2c40f882ad5d9f16fe8a7b2edd7bdf6f90930042612201bdedda4951",
"license": "MIT",
"category": "platform/agents"
},
@@ -92,7 +92,7 @@
"type": "skill-md",
"description": "Find a three.ws agent that already does the job, then buy its skill or have one of your own agents hire and pay it autonomously over x402. Use when you or the user want to hire, rent, buy, delegate to, or pay another AI agent or one of its skills (\"find an agent that can do X\", \"hire an agent to write this\", \"buy that skill\", \"let my agent pay another agent\", \"how much does that skill cost\", \"what did my agent spend\"). Covers browsing the offer catalog, free trials, Solana Pay checkout, agent-to-agent hiring with spend caps, and the receipts.",
"url": "https://three.ws/.well-known/agent-skills/hire-an-agent/SKILL.md",
- "digest": "sha256:ad8b7dacab5566fdc1c8dd6bcadbe418f86823d955be3817df9bb446c21546a1",
+ "digest": "sha256:a0423dcf05a76e91bc15b9dd78cd4a1f8ac2c436cccdc8de3c84fb98f090e59a",
"license": "MIT",
"category": "platform/agents"
},
@@ -101,7 +101,7 @@
"type": "skill-md",
"description": "Publish an agent skill to the three.ws marketplace, price it per call in $THREE or USDC, offer a metered free trial, and collect the earnings. Use when you or the user want to sell, monetize, price, list, or make money from an agent skill or capability (\"sell my skill\", \"charge per call\", \"price this skill in $THREE\", \"put my agent's skill on the marketplace\", \"where are my skill earnings\", \"set up a free trial\"). Covers publishing to the catalog, the per-call x402 rail, the author/platform split, trials, payout wallet, and withdrawals.",
"url": "https://three.ws/.well-known/agent-skills/sell-an-agent-skill/SKILL.md",
- "digest": "sha256:8aef691620347811e3f0e45e0561ef2ab024e938889701643d7b174f7cf57e1c",
+ "digest": "sha256:79684f7d88dd0ae1a5d455ef98215987637ed411411f1b373681e9ac216e878a",
"license": "MIT",
"category": "platform/agents"
},
@@ -110,7 +110,7 @@
"type": "skill-md",
"description": "Sign in to the wallet. Use when you or the user want to log in, sign in, connect, or set up the wallet, or when any wallet operation fails with authentication or \"not signed in\" errors. This skill is a prerequisite before sending, trading, or funding.",
"url": "https://three.ws/.well-known/agent-skills/authenticate-wallet/SKILL.md",
- "digest": "sha256:22bcfe32ff0a4168083e417055ec81dbdec418c700cdd177fa8bf86bae6cfd74",
+ "digest": "sha256:76d5f4be220a366734049a06244ffb1dd3e6c18dd0494928fcce7e36bac6bd19",
"category": "wallet/payments"
},
{
@@ -118,7 +118,7 @@
"type": "skill-md",
"description": "Add money to the wallet. Use when you or the user want to fund, deposit, top up, load, buy USDC, add funds, onramp, or get USDC. Also use when the wallet has insufficient balance for a send or trade operation, or when someone asks \"how do I get USDC?\"",
"url": "https://three.ws/.well-known/agent-skills/fund/SKILL.md",
- "digest": "sha256:e63c037e40e5799af0b7ebba6e4868f77d252d2aa8d337329fa96b3cd38fff36",
+ "digest": "sha256:6f778e531fda801b29d3e910d2161d3513cfdc03273844b92ca733c8c96b8a08",
"category": "wallet/payments"
},
{
@@ -126,7 +126,7 @@
"type": "skill-md",
"description": "Build and deploy a paid API that other agents can pay to use via x402. Use when you or the user want to monetize an API, make money, earn money, offer a service, sell a service to other agents, charge for endpoints, create a paid endpoint, or set up a paid service. Covers \"make money by offering an endpoint\", \"sell a service\", \"monetize your data\", \"create a paid API\".",
"url": "https://three.ws/.well-known/agent-skills/monetize-service/SKILL.md",
- "digest": "sha256:a98b4e724c7f432575e217d84966de3f6536ed870e69784f3ab03d601b5fce72",
+ "digest": "sha256:c409700be27b4773667e6d4c96e757d0abc615850b9d3c8a18f2bed6165769f6",
"category": "wallet/payments"
},
{
@@ -134,7 +134,7 @@
"type": "skill-md",
"description": "Make a paid API request to an x402 endpoint with automatic USDC payment. Use when you or the user want to call a paid API, make an x402 request, use a paid service, or pay for an API call. Use after finding a service with search-for-service. This is the three.ws-native x402 payer (awal, USDC on Base) and is the default; defer to okx-agent-payments-protocol only when the user names OKX/OnchainOS, or the 402 is channel/voucher/session/permit2/MPP/a2a-pay based rather than a plain awal x402 pay.",
"url": "https://three.ws/.well-known/agent-skills/pay-for-service/SKILL.md",
- "digest": "sha256:7a8fd1d3c11d34504b19fee2b5acd97e1eeaf967149c5a98ab21cf0c2281b4a9",
+ "digest": "sha256:4cdc38b560a5730b1cf5238cca610a6fa86cbb7da773934872cf755ee09d66d6",
"category": "wallet/payments"
},
{
@@ -142,7 +142,7 @@
"type": "skill-md",
"description": "Query onchain data on Base using the CDP SQL API via x402. Use when you or your user want to view onchain information about decoded blocks, transactions, and events.",
"url": "https://three.ws/.well-known/agent-skills/query-onchain-data/SKILL.md",
- "digest": "sha256:dd71ea2949a9786aa986f3af1f6c5291af607e2bcdb86f4bccf22ae60f43edb6",
+ "digest": "sha256:e2e9a4ee248583c794647c71da753ebc853e2c5d2f3a252ca25f413675b26c5d",
"category": "wallet/payments"
},
{
@@ -150,7 +150,7 @@
"type": "skill-md",
"description": "Search and browse the x402 bazaar marketplace for paid API services. Use when you or the user want to find available services, see what's available, discover APIs, or need an external service to accomplish a task. Also use as a fallback when no other skill clearly matches: search the bazaar to see if a paid service exists. Covers \"what can I do?\", \"find me an API for...\", \"what services are available?\", \"search for...\", \"browse the bazaar\".",
"url": "https://three.ws/.well-known/agent-skills/search-for-service/SKILL.md",
- "digest": "sha256:a630c1f0b8ca63fcde1126f889f5b8f3e1a93e5710f69dd84a87b451467e5328",
+ "digest": "sha256:2db257e3af647daf066edd2154bef4e6caf548dc0b9a1da03d0cb304fcf3bd12",
"category": "wallet/payments"
},
{
@@ -158,7 +158,7 @@
"type": "skill-md",
"description": "Send tokens (USDC, ETH, POL, or SOL) to an address or ENS name on Base, Polygon, or Solana. Use when you or the user want to send money, pay someone, transfer tokens, tip, donate, or send funds to a wallet address or .eth name. Covers phrases like \"send $5 to\", \"pay 0x...\", \"transfer to vitalik.eth\", or \"send USDC on Solana\". This is the three.ws-native wallet (awal) and is the default for sends; defer to okx-agentic-wallet only when the user names OKX, OnchainOS, an OKX-managed / Agentic Wallet account, or an OKX-specific chain/venue (e.g. X Layer).",
"url": "https://three.ws/.well-known/agent-skills/send-usdc/SKILL.md",
- "digest": "sha256:910afb699cdccdb8c7fe276ad3db2ca138225c2ad742b0bd89b4b568f81110b7",
+ "digest": "sha256:80b85808bdfce893fc642cc8649e858009fdd7cc2d4852111fc20d121ead0d53",
"category": "wallet/payments"
},
{
@@ -166,7 +166,7 @@
"type": "skill-md",
"description": "Swap or trade tokens on Base or Polygon. Use when you or the user want to trade, swap, exchange, buy, sell, or convert between tokens like USDC, ETH, and POL. Covers phrases like \"buy ETH\", \"sell ETH for USDC\", \"convert USDC to ETH\", \"get some ETH\", \"buy POL\". This is the three.ws-native wallet (awal) and is the default for swaps; defer to okx-dex-swap only when the user names OKX, OnchainOS, an OKX-managed account, a named DEX/DApp venue, or an OKX-specific chain (e.g. X Layer, BSC, Arbitrum).",
"url": "https://three.ws/.well-known/agent-skills/trade/SKILL.md",
- "digest": "sha256:d6081f3da8282db1e7bb9aa7abb64ee54f2e9c054b6202ee4a4955ce42a15af1",
+ "digest": "sha256:ad12768905ca19381a73d8fd38feb61750712f537a6182041196a5f47470a4f0",
"category": "wallet/payments"
},
{
@@ -174,7 +174,7 @@
"type": "skill-md",
"description": "Search for new services and make paid API requests using the x402 payment protocol. Use when you don't have a clear tool to choose, search the bazaar. You can also use this tool if you or the user want to call an x402 endpoint, discover payment requirements, browse the bazaar, or search for paid services. This is the three.ws-native x402 stack (awal, USDC on Base) and is the default; defer to okx-agent-payments-protocol only when the user names OKX/OnchainOS, or the 402 is channel/voucher/session/permit2/MPP/a2a-pay based rather than a plain awal x402 pay.",
"url": "https://three.ws/.well-known/agent-skills/x402/SKILL.md",
- "digest": "sha256:a9806cd3186e2e09993b07036f3782d7b828fe77e851f21e761f7abcca44b754",
+ "digest": "sha256:d5d6139d39ebe2863c71b4e7337cfa6e57066e2a33948f4fa31a166fdb7a1c5f",
"category": "wallet/payments"
}
]
diff --git a/public/.well-known/agent-skills/monetize-service/SKILL.md b/public/.well-known/agent-skills/monetize-service/SKILL.md
index 268d851da..6ef69ee5a 100644
--- a/public/.well-known/agent-skills/monetize-service/SKILL.md
+++ b/public/.well-known/agent-skills/monetize-service/SKILL.md
@@ -3,10 +3,10 @@ name: monetize-service
description: Build and deploy a paid API that other agents can pay to use via x402. Use when you or the user want to monetize an API, make money, earn money, offer a service, sell a service to other agents, charge for endpoints, create a paid endpoint, or set up a paid service. Covers "make money by offering an endpoint", "sell a service", "monetize your data", "create a paid API".
user-invocable: true
disable-model-invocation: false
-allowed-tools: ["Bash(npx [email protected] status*)", "Bash(npx [email protected] address*)", "Bash(npx [email protected] x402 details *)", "Bash(npx [email protected] x402 pay *)", "Bash(npm *)", "Bash(node *)", "Bash(curl *)", "Bash(mkdir *)"]
+allowed-tools: "Bash(npx [email protected] status*) Bash(npx [email protected] address*) Bash(npx [email protected] x402 details *) Bash(npx [email protected] x402 pay *) Bash(npm *) Bash(node *) Bash(curl *) Bash(mkdir *)"
metadata:
category: wallet/payments
- cross-platform-safe: false
+ cross-platform-safe: "false"
pack: three-ws-skills
---
diff --git a/public/.well-known/agent-skills/pay-for-service/SKILL.md b/public/.well-known/agent-skills/pay-for-service/SKILL.md
index bb0cd0749..496d6c0a9 100644
--- a/public/.well-known/agent-skills/pay-for-service/SKILL.md
+++ b/public/.well-known/agent-skills/pay-for-service/SKILL.md
@@ -3,10 +3,10 @@ name: pay-for-service
description: Make a paid API request to an x402 endpoint with automatic USDC payment. Use when you or the user want to call a paid API, make an x402 request, use a paid service, or pay for an API call. Use after finding a service with search-for-service. This is the three.ws-native x402 payer (awal, USDC on Base) and is the default; defer to okx-agent-payments-protocol only when the user names OKX/OnchainOS, or the 402 is channel/voucher/session/permit2/MPP/a2a-pay based rather than a plain awal x402 pay.
user-invocable: true
disable-model-invocation: false
-allowed-tools: ["Bash(npx [email protected] status*)", "Bash(npx [email protected] balance*)", "Bash(npx [email protected] x402 pay *)"]
+allowed-tools: "Bash(npx [email protected] status*) Bash(npx [email protected] balance*) Bash(npx [email protected] x402 pay *)"
metadata:
category: wallet/payments
- cross-platform-safe: false
+ cross-platform-safe: "false"
pack: three-ws-skills
---
diff --git a/public/.well-known/agent-skills/query-onchain-data/SKILL.md b/public/.well-known/agent-skills/query-onchain-data/SKILL.md
index f1b3afd7f..42738e988 100644
--- a/public/.well-known/agent-skills/query-onchain-data/SKILL.md
+++ b/public/.well-known/agent-skills/query-onchain-data/SKILL.md
@@ -3,10 +3,10 @@ name: query-onchain-data
description: Query onchain data on Base using the CDP SQL API via x402. Use when you or your user want to view onchain information about decoded blocks, transactions, and events.
user-invocable: true
disable-model-invocation: false
-allowed-tools: ["Bash(npx [email protected] status*)", "Bash(npx [email protected] balance*)", "Bash(npx [email protected] x402 pay *)"]
+allowed-tools: "Bash(npx [email protected] status*) Bash(npx [email protected] balance*) Bash(npx [email protected] x402 pay *)"
metadata:
category: wallet/payments
- cross-platform-safe: false
+ cross-platform-safe: "false"
pack: three-ws-skills
---
diff --git a/public/.well-known/agent-skills/rig-a-model/SKILL.md b/public/.well-known/agent-skills/rig-a-model/SKILL.md
index 2bb2d5762..2662ab99f 100644
--- a/public/.well-known/agent-skills/rig-a-model/SKILL.md
+++ b/public/.well-known/agent-skills/rig-a-model/SKILL.md
@@ -5,7 +5,7 @@ when_to_use: User already has a GLB (a URL) and wants it rigged. To generate a n
license: MIT
metadata:
category: 3d/creative
- cross-platform-safe: true
+ cross-platform-safe: "true"
pack: three-ws-skills
---
diff --git a/public/.well-known/agent-skills/search-for-service/SKILL.md b/public/.well-known/agent-skills/search-for-service/SKILL.md
index e5526d019..c50c56089 100644
--- a/public/.well-known/agent-skills/search-for-service/SKILL.md
+++ b/public/.well-known/agent-skills/search-for-service/SKILL.md
@@ -1,12 +1,13 @@
---
name: search-for-service
-description: Search and browse the x402 bazaar marketplace for paid API services. Use when you or the user want to find available services, see what's available, discover APIs, or need an external service to accomplish a task. Also use as a fallback when no other skill clearly matches: search the bazaar to see if a paid service exists. Covers "what can I do?", "find me an API for...", "what services are available?", "search for...", "browse the bazaar".
+description: >-
+ Search and browse the x402 bazaar marketplace for paid API services. Use when you or the user want to find available services, see what's available, discover APIs, or need an external service to accomplish a task. Also use as a fallback when no other skill clearly matches: search the bazaar to see if a paid service exists. Covers "what can I do?", "find me an API for...", "what services are available?", "search for...", "browse the bazaar".
user-invocable: true
disable-model-invocation: false
-allowed-tools: ["Bash(npx [email protected] x402 bazaar *)", "Bash(npx [email protected] x402 details *)"]
+allowed-tools: "Bash(npx [email protected] x402 bazaar *) Bash(npx [email protected] x402 details *)"
metadata:
category: wallet/payments
- cross-platform-safe: false
+ cross-platform-safe: "false"
pack: three-ws-skills
---
diff --git a/public/.well-known/agent-skills/sell-an-agent-skill/SKILL.md b/public/.well-known/agent-skills/sell-an-agent-skill/SKILL.md
index 1657fc6b8..0493b052e 100644
--- a/public/.well-known/agent-skills/sell-an-agent-skill/SKILL.md
+++ b/public/.well-known/agent-skills/sell-an-agent-skill/SKILL.md
@@ -5,7 +5,7 @@ when_to_use: The user has a capability and wants income from it. To author the s
license: MIT
metadata:
category: platform/agents
- cross-platform-safe: false
+ cross-platform-safe: "false"
pack: three-ws-skills
---
diff --git a/public/.well-known/agent-skills/send-usdc/SKILL.md b/public/.well-known/agent-skills/send-usdc/SKILL.md
index 44b19a95d..1e3c7b9c7 100644
--- a/public/.well-known/agent-skills/send-usdc/SKILL.md
+++ b/public/.well-known/agent-skills/send-usdc/SKILL.md
@@ -3,10 +3,10 @@ name: send-usdc
description: Send tokens (USDC, ETH, POL, or SOL) to an address or ENS name on Base, Polygon, or Solana. Use when you or the user want to send money, pay someone, transfer tokens, tip, donate, or send funds to a wallet address or .eth name. Covers phrases like "send $5 to", "pay 0x...", "transfer to vitalik.eth", or "send USDC on Solana". This is the three.ws-native wallet (awal) and is the default for sends; defer to okx-agentic-wallet only when the user names OKX, OnchainOS, an OKX-managed / Agentic Wallet account, or an OKX-specific chain/venue (e.g. X Layer).
user-invocable: true
disable-model-invocation: false
-allowed-tools: ["Bash(npx [email protected] status*)", "Bash(npx [email protected] send *)", "Bash(npx [email protected] balance*)"]
+allowed-tools: "Bash(npx [email protected] status*) Bash(npx [email protected] send *) Bash(npx [email protected] balance*)"
metadata:
category: wallet/payments
- cross-platform-safe: false
+ cross-platform-safe: "false"
pack: three-ws-skills
---
diff --git a/public/.well-known/agent-skills/trade/SKILL.md b/public/.well-known/agent-skills/trade/SKILL.md
index 57cfda36b..0c7a0420f 100644
--- a/public/.well-known/agent-skills/trade/SKILL.md
+++ b/public/.well-known/agent-skills/trade/SKILL.md
@@ -3,10 +3,10 @@ name: trade
description: Swap or trade tokens on Base or Polygon. Use when you or the user want to trade, swap, exchange, buy, sell, or convert between tokens like USDC, ETH, and POL. Covers phrases like "buy ETH", "sell ETH for USDC", "convert USDC to ETH", "get some ETH", "buy POL". This is the three.ws-native wallet (awal) and is the default for swaps; defer to okx-dex-swap only when the user names OKX, OnchainOS, an OKX-managed account, a named DEX/DApp venue, or an OKX-specific chain (e.g. X Layer, BSC, Arbitrum).
user-invocable: true
disable-model-invocation: false
-allowed-tools: ["Bash(npx [email protected] status*)", "Bash(npx [email protected] trade *)", "Bash(npx [email protected] balance*)"]
+allowed-tools: "Bash(npx [email protected] status*) Bash(npx [email protected] trade *) Bash(npx [email protected] balance*)"
metadata:
category: wallet/payments
- cross-platform-safe: false
+ cross-platform-safe: "false"
pack: three-ws-skills
---
diff --git a/public/.well-known/agent-skills/x402/SKILL.md b/public/.well-known/agent-skills/x402/SKILL.md
index debbe3006..b6ba9740d 100644
--- a/public/.well-known/agent-skills/x402/SKILL.md
+++ b/public/.well-known/agent-skills/x402/SKILL.md
@@ -5,7 +5,7 @@ user-invocable: true
disable-model-invocation: false
metadata:
category: wallet/payments
- cross-platform-safe: false
+ cross-platform-safe: "false"
pack: three-ws-skills
---
diff --git a/public/.well-known/skills/index.json b/public/.well-known/skills/index.json
index 46e8407c4..b7934f919 100644
--- a/public/.well-known/skills/index.json
+++ b/public/.well-known/skills/index.json
@@ -11,7 +11,7 @@
"type": "skill-md",
"description": "Explain how a machine works as an interactive isometric 3D cutaway. Use when the user asks how an engine, turbine, reactor, pump, clock, motor or any mechanism works and wants to see it, or types \"/anatomy <machine>\", for example \"/anatomy explain how a big airliner turbofan engine like the A380's makes thrust, interactive\". Produces a shareable three.ws link with real moving parts, shader effects (fire, exhaust, plasma, water, steam, sparks, arcs), flows, a section cut, an exploded view and a guided tour.",
"url": "https://three.ws/.well-known/agent-skills/anatomy/SKILL.md",
- "digest": "sha256:ea5ce6ea7d3e81791d870956c331403f2a278d7357e0a357f7d41dbf7a34c831",
+ "digest": "sha256:cbce16e48252311ae41f4f70ccc5118a7e81731b0dbbe91215a1370b4c7fd39e",
"license": "MIT",
"category": "3d/creative"
},
@@ -20,7 +20,7 @@
"type": "skill-md",
"description": "Turn a text prompt (or reference image) into a rigged, animation-ready 3D avatar (GLB). Use when you or the user want to create, generate, or make a 3D avatar, character, or humanoid figure that can be posed and animated, for example \"make a 3D avatar of a knight\", \"generate a character I can animate\", \"create a rigged astronaut\". Generates the mesh and adds a humanoid skeleton in one step. Returns a GLB URL plus a pose-studio link.",
"url": "https://three.ws/.well-known/agent-skills/create-3d-avatar/SKILL.md",
- "digest": "sha256:67d694905dd52cb005f47b279c5bb728e7f2ae3f4502720cf34dda6304d79fae",
+ "digest": "sha256:2eb74982a85bb4acf3c723473ec67476f1d4f27376d90a863cb23efb684fe71c",
"license": "MIT",
"category": "3d/creative"
},
@@ -29,7 +29,7 @@
"type": "skill-md",
"description": "Embed a live, animated three.ws 3D avatar in any website with the <agent-3d> web component. Use when you or the user want to embed, integrate, add, or show a 3D avatar, character, or agent on a site or app (\"embed a 3D avatar on my site\", \"add an animated character to my landing page\", \"integrate three.ws\", \"put an avatar in my hero section\"), wire avatar animations or moods from page code, let users design an avatar in the three.ws Avatar Studio from inside another app, or debug an existing agent-3d embed.",
"url": "https://three.ws/.well-known/agent-skills/embed-three-ws-avatar/SKILL.md",
- "digest": "sha256:938d4b89c1c44146cff645687bbb82fe76d02f1a5237e1e0c824db6f1c7f0ac4",
+ "digest": "sha256:020ff7ec2294b814340839c2cece03d648a086035b069df42fa7df6dba299b0b",
"license": "MIT",
"category": "3d/creative"
},
@@ -38,7 +38,7 @@
"type": "skill-md",
"description": "Search thousands of ready-made 3D assets on three.ws (CC0 props and objects, rigged humanoid characters, motion clips) and get paste-ready code or a downloaded file. Use when you or the user need a 3D model, prop, object, character, or animation for a scene, site, game, or app (\"I need a 3D chair\", \"find a rigged character\", \"is there a wave animation\", \"add a lamp model to my page\"). Free: no account, no API key, no payment. Check here BEFORE generating a model from scratch.",
"url": "https://three.ws/.well-known/agent-skills/find-3d-assets/SKILL.md",
- "digest": "sha256:fb3bde90a796628b97da99a0e9099afc5ac07d76f46abb191b43b781a4a7ce3a",
+ "digest": "sha256:02ff790e10db03750b27ea0f9b79ee846a2175452e076f8f30e866ddab9f269c",
"license": "MIT",
"category": "3d/creative"
},
@@ -47,7 +47,7 @@
"type": "skill-md",
"description": "Turn a text prompt into a downloadable, textured 3D model (GLB). Use when you or the user want to generate, create, make, or forge a 3D model, asset, object, mesh, or prop from a text description, for example \"make a 3D model of a robot\", \"generate a GLB of a sword\", \"I need a 3D chair\". Runs on the FREE text→3D lane (no key, no account, free). Returns a GLB URL plus a browser viewer link.",
"url": "https://three.ws/.well-known/agent-skills/generate-3d-model/SKILL.md",
- "digest": "sha256:114795c9b8e8794537de8eb02f4a7fe0d33f90c22eca9b0f0c735a473f5ebf05",
+ "digest": "sha256:953aa9d307d97bdd0ee0b1e2aa888f0afc6e41c31c3803a1f008e86fdc7e39cb",
"license": "MIT",
"category": "3d/creative"
},
@@ -56,7 +56,7 @@
"type": "skill-md",
"description": "Auto-rig a static 3D GLB model into an animation-ready one. Use when you or the user have an existing GLB and want to rig it, add a skeleton, add bones, make it posable, or make it animatable, for example \"rig this model\", \"add a skeleton to my GLB\", \"make this character animation-ready\". Takes a GLB URL, adds a humanoid skeleton plus skin weights, and returns the rigged GLB URL and a pose-studio link.",
"url": "https://three.ws/.well-known/agent-skills/rig-a-model/SKILL.md",
- "digest": "sha256:6b5eb4fc712f9e73f7213ff901ae5778db85434c8076f46956846a9c596839ee",
+ "digest": "sha256:e092d3a45dcb3584d090c16c7d136dd2dc8e53083019b5eb54db6a25ba6987ae",
"license": "MIT",
"category": "3d/creative"
},
@@ -65,7 +65,7 @@
"type": "skill-md",
"description": "Write a real three.ws agent skill bundle (manifest.json + SKILL.md + tools.json + handlers.js) that gives a 3D agent a new capability, then install it on an agent and test it. Use when you or the user want to build, write, author, or code a custom skill, capability, tool, or ability for a three.ws agent or an <agent-3d> embed (\"give my agent a new skill\", \"make my agent able to check the weather\", \"write a custom tool for my avatar\", \"add a gesture skill\"). Covers the four-file bundle layout, the handler context API, the sandbox limits, trust policy, and how to install the bundle.",
"url": "https://three.ws/.well-known/agent-skills/build-an-agent-skill/SKILL.md",
- "digest": "sha256:0a1e49c876aacb76d8e46eafda2b025da0ec7f0f050778e29796b905237e71e3",
+ "digest": "sha256:2569dc89a057d08a4c4f932efbb57503b02e2cd28a419d51d440d3802031e7a7",
"license": "MIT",
"category": "platform/agents"
},
@@ -74,7 +74,7 @@
"type": "skill-md",
"description": "Connect any MCP client (Claude Code, Claude Desktop, the Agent SDK, or a custom one) to the three.ws MCP servers, so the model can generate 3D models and avatars, read and write agent data, and pay for services. Use when you or the user want to connect, add, install, configure, wire up, or debug three.ws MCP, an MCP server for 3D or avatars or agent wallets, a .mcp.json entry, or \"give Claude access to three.ws\". Also use to pick which of the hosted servers to add, and to test a connection that is not working.",
"url": "https://three.ws/.well-known/agent-skills/connect-three-ws-mcp/SKILL.md",
- "digest": "sha256:66e5b3ef8b1c644d12945b8042a8c2bd8672fdd8ca78970f782d9abe618c2c77",
+ "digest": "sha256:60b739152003a616ec661fa744faa93aa21fa7123c6d66604fb58b43b352928d",
"license": "MIT",
"category": "platform/agents"
},
@@ -83,7 +83,7 @@
"type": "skill-md",
"description": "Create a real three.ws AI agent (identity, 3D body, custodial Solana wallet, persona) from the command line and get its live public page. Use when you or the user want to create, build, deploy, launch, or set up an AI agent, a 3D agent, an on-chain agent, or \"my own agent\" on three.ws, attach a 3D body to an existing agent, edit an agent's persona or brain, or list the agents an account already owns. Returns the agent id, its Solana wallet address, and the public URL anyone can visit and chat with.",
"url": "https://three.ws/.well-known/agent-skills/create-a-three-ws-agent/SKILL.md",
- "digest": "sha256:8aa823202c36af857b791bcc57c5b8220ef88c869e7426f0c1184172008a62cb",
+ "digest": "sha256:bdc250bc2c40f882ad5d9f16fe8a7b2edd7bdf6f90930042612201bdedda4951",
"license": "MIT",
"category": "platform/agents"
},
@@ -92,7 +92,7 @@
"type": "skill-md",
"description": "Find a three.ws agent that already does the job, then buy its skill or have one of your own agents hire and pay it autonomously over x402. Use when you or the user want to hire, rent, buy, delegate to, or pay another AI agent or one of its skills (\"find an agent that can do X\", \"hire an agent to write this\", \"buy that skill\", \"let my agent pay another agent\", \"how much does that skill cost\", \"what did my agent spend\"). Covers browsing the offer catalog, free trials, Solana Pay checkout, agent-to-agent hiring with spend caps, and the receipts.",
"url": "https://three.ws/.well-known/agent-skills/hire-an-agent/SKILL.md",
- "digest": "sha256:ad8b7dacab5566fdc1c8dd6bcadbe418f86823d955be3817df9bb446c21546a1",
+ "digest": "sha256:a0423dcf05a76e91bc15b9dd78cd4a1f8ac2c436cccdc8de3c84fb98f090e59a",
"license": "MIT",
"category": "platform/agents"
},
@@ -101,7 +101,7 @@
"type": "skill-md",
"description": "Publish an agent skill to the three.ws marketplace, price it per call in $THREE or USDC, offer a metered free trial, and collect the earnings. Use when you or the user want to sell, monetize, price, list, or make money from an agent skill or capability (\"sell my skill\", \"charge per call\", \"price this skill in $THREE\", \"put my agent's skill on the marketplace\", \"where are my skill earnings\", \"set up a free trial\"). Covers publishing to the catalog, the per-call x402 rail, the author/platform split, trials, payout wallet, and withdrawals.",
"url": "https://three.ws/.well-known/agent-skills/sell-an-agent-skill/SKILL.md",
- "digest": "sha256:8aef691620347811e3f0e45e0561ef2ab024e938889701643d7b174f7cf57e1c",
+ "digest": "sha256:79684f7d88dd0ae1a5d455ef98215987637ed411411f1b373681e9ac216e878a",
"license": "MIT",
"category": "platform/agents"
},
@@ -110,7 +110,7 @@
"type": "skill-md",
"description": "Sign in to the wallet. Use when you or the user want to log in, sign in, connect, or set up the wallet, or when any wallet operation fails with authentication or \"not signed in\" errors. This skill is a prerequisite before sending, trading, or funding.",
"url": "https://three.ws/.well-known/agent-skills/authenticate-wallet/SKILL.md",
- "digest": "sha256:22bcfe32ff0a4168083e417055ec81dbdec418c700cdd177fa8bf86bae6cfd74",
+ "digest": "sha256:76d5f4be220a366734049a06244ffb1dd3e6c18dd0494928fcce7e36bac6bd19",
"category": "wallet/payments"
},
{
@@ -118,7 +118,7 @@
"type": "skill-md",
"description": "Add money to the wallet. Use when you or the user want to fund, deposit, top up, load, buy USDC, add funds, onramp, or get USDC. Also use when the wallet has insufficient balance for a send or trade operation, or when someone asks \"how do I get USDC?\"",
"url": "https://three.ws/.well-known/agent-skills/fund/SKILL.md",
- "digest": "sha256:e63c037e40e5799af0b7ebba6e4868f77d252d2aa8d337329fa96b3cd38fff36",
+ "digest": "sha256:6f778e531fda801b29d3e910d2161d3513cfdc03273844b92ca733c8c96b8a08",
"category": "wallet/payments"
},
{
@@ -126,7 +126,7 @@
"type": "skill-md",
"description": "Build and deploy a paid API that other agents can pay to use via x402. Use when you or the user want to monetize an API, make money, earn money, offer a service, sell a service to other agents, charge for endpoints, create a paid endpoint, or set up a paid service. Covers \"make money by offering an endpoint\", \"sell a service\", \"monetize your data\", \"create a paid API\".",
"url": "https://three.ws/.well-known/agent-skills/monetize-service/SKILL.md",
- "digest": "sha256:a98b4e724c7f432575e217d84966de3f6536ed870e69784f3ab03d601b5fce72",
+ "digest": "sha256:c409700be27b4773667e6d4c96e757d0abc615850b9d3c8a18f2bed6165769f6",
"category": "wallet/payments"
},
{
@@ -134,7 +134,7 @@
"type": "skill-md",
"description": "Make a paid API request to an x402 endpoint with automatic USDC payment. Use when you or the user want to call a paid API, make an x402 request, use a paid service, or pay for an API call. Use after finding a service with search-for-service. This is the three.ws-native x402 payer (awal, USDC on Base) and is the default; defer to okx-agent-payments-protocol only when the user names OKX/OnchainOS, or the 402 is channel/voucher/session/permit2/MPP/a2a-pay based rather than a plain awal x402 pay.",
"url": "https://three.ws/.well-known/agent-skills/pay-for-service/SKILL.md",
- "digest": "sha256:7a8fd1d3c11d34504b19fee2b5acd97e1eeaf967149c5a98ab21cf0c2281b4a9",
+ "digest": "sha256:4cdc38b560a5730b1cf5238cca610a6fa86cbb7da773934872cf755ee09d66d6",
"category": "wallet/payments"
},
{
@@ -142,7 +142,7 @@
"type": "skill-md",
"description": "Query onchain data on Base using the CDP SQL API via x402. Use when you or your user want to view onchain information about decoded blocks, transactions, and events.",
"url": "https://three.ws/.well-known/agent-skills/query-onchain-data/SKILL.md",
- "digest": "sha256:dd71ea2949a9786aa986f3af1f6c5291af607e2bcdb86f4bccf22ae60f43edb6",
+ "digest": "sha256:e2e9a4ee248583c794647c71da753ebc853e2c5d2f3a252ca25f413675b26c5d",
"category": "wallet/payments"
},
{
@@ -150,7 +150,7 @@
"type": "skill-md",
"description": "Search and browse the x402 bazaar marketplace for paid API services. Use when you or the user want to find available services, see what's available, discover APIs, or need an external service to accomplish a task. Also use as a fallback when no other skill clearly matches: search the bazaar to see if a paid service exists. Covers \"what can I do?\", \"find me an API for...\", \"what services are available?\", \"search for...\", \"browse the bazaar\".",
"url": "https://three.ws/.well-known/agent-skills/search-for-service/SKILL.md",
- "digest": "sha256:a630c1f0b8ca63fcde1126f889f5b8f3e1a93e5710f69dd84a87b451467e5328",
+ "digest": "sha256:2db257e3af647daf066edd2154bef4e6caf548dc0b9a1da03d0cb304fcf3bd12",
"category": "wallet/payments"
},
{
@@ -158,7 +158,7 @@
"type": "skill-md",
"description": "Send tokens (USDC, ETH, POL, or SOL) to an address or ENS name on Base, Polygon, or Solana. Use when you or the user want to send money, pay someone, transfer tokens, tip, donate, or send funds to a wallet address or .eth name. Covers phrases like \"send $5 to\", \"pay 0x...\", \"transfer to vitalik.eth\", or \"send USDC on Solana\". This is the three.ws-native wallet (awal) and is the default for sends; defer to okx-agentic-wallet only when the user names OKX, OnchainOS, an OKX-managed / Agentic Wallet account, or an OKX-specific chain/venue (e.g. X Layer).",
"url": "https://three.ws/.well-known/agent-skills/send-usdc/SKILL.md",
- "digest": "sha256:910afb699cdccdb8c7fe276ad3db2ca138225c2ad742b0bd89b4b568f81110b7",
+ "digest": "sha256:80b85808bdfce893fc642cc8649e858009fdd7cc2d4852111fc20d121ead0d53",
"category": "wallet/payments"
},
{
@@ -166,7 +166,7 @@
"type": "skill-md",
"description": "Swap or trade tokens on Base or Polygon. Use when you or the user want to trade, swap, exchange, buy, sell, or convert between tokens like USDC, ETH, and POL. Covers phrases like \"buy ETH\", \"sell ETH for USDC\", \"convert USDC to ETH\", \"get some ETH\", \"buy POL\". This is the three.ws-native wallet (awal) and is the default for swaps; defer to okx-dex-swap only when the user names OKX, OnchainOS, an OKX-managed account, a named DEX/DApp venue, or an OKX-specific chain (e.g. X Layer, BSC, Arbitrum).",
"url": "https://three.ws/.well-known/agent-skills/trade/SKILL.md",
- "digest": "sha256:d6081f3da8282db1e7bb9aa7abb64ee54f2e9c054b6202ee4a4955ce42a15af1",
+ "digest": "sha256:ad12768905ca19381a73d8fd38feb61750712f537a6182041196a5f47470a4f0",
"category": "wallet/payments"
},
{
@@ -174,7 +174,7 @@
"type": "skill-md",
"description": "Search for new services and make paid API requests using the x402 payment protocol. Use when you don't have a clear tool to choose, search the bazaar. You can also use this tool if you or the user want to call an x402 endpoint, discover payment requirements, browse the bazaar, or search for paid services. This is the three.ws-native x402 stack (awal, USDC on Base) and is the default; defer to okx-agent-payments-protocol only when the user names OKX/OnchainOS, or the 402 is channel/voucher/session/permit2/MPP/a2a-pay based rather than a plain awal x402 pay.",
"url": "https://three.ws/.well-known/agent-skills/x402/SKILL.md",
- "digest": "sha256:a9806cd3186e2e09993b07036f3782d7b828fe77e851f21e761f7abcca44b754",
+ "digest": "sha256:d5d6139d39ebe2863c71b4e7337cfa6e57066e2a33948f4fa31a166fdb7a1c5f",
"category": "wallet/payments"
}
]
diff --git a/public/skills/3d-studio/anatomy/SKILL.md b/public/skills/3d-studio/anatomy/SKILL.md
index 1ec363690..d04aae515 100644
--- a/public/skills/3d-studio/anatomy/SKILL.md
+++ b/public/skills/3d-studio/anatomy/SKILL.md
@@ -5,7 +5,7 @@ when_to_use: The user wants a machine or mechanism explained visually and intera
license: MIT
metadata:
category: 3d/creative
- cross-platform-safe: true
+ cross-platform-safe: "true"
pack: three-ws-skills
---
diff --git a/public/skills/3d-studio/create-3d-avatar/SKILL.md b/public/skills/3d-studio/create-3d-avatar/SKILL.md
index 716643fee..e098e1e39 100644
--- a/public/skills/3d-studio/create-3d-avatar/SKILL.md
+++ b/public/skills/3d-studio/create-3d-avatar/SKILL.md
@@ -5,7 +5,7 @@ when_to_use: User wants a posable/animatable humanoid character. For a static ob
license: MIT
metadata:
category: 3d/creative
- cross-platform-safe: true
+ cross-platform-safe: "true"
pack: three-ws-skills
---
diff --git a/public/skills/3d-studio/embed-three-ws-avatar/SKILL.md b/public/skills/3d-studio/embed-three-ws-avatar/SKILL.md
index 74cac29be..9545b8b2e 100644
--- a/public/skills/3d-studio/embed-three-ws-avatar/SKILL.md
+++ b/public/skills/3d-studio/embed-three-ws-avatar/SKILL.md
@@ -5,7 +5,7 @@ when_to_use: A site or app (any framework, or plain HTML) should display or cont
license: MIT
metadata:
category: 3d/creative
- cross-platform-safe: true
+ cross-platform-safe: "true"
pack: three-ws-skills
---
diff --git a/public/skills/3d-studio/find-3d-assets/SKILL.md b/public/skills/3d-studio/find-3d-assets/SKILL.md
index a8bc902ce..2f1268027 100644
--- a/public/skills/3d-studio/find-3d-assets/SKILL.md
+++ b/public/skills/3d-studio/find-3d-assets/SKILL.md
@@ -1,11 +1,12 @@
---
name: find-3d-assets
-description: Search thousands of ready-made 3D assets on three.ws (CC0 props and objects, rigged humanoid characters, motion clips) and get paste-ready code or a downloaded file. Use when you or the user need a 3D model, prop, object, character, or animation for a scene, site, game, or app ("I need a 3D chair", "find a rigged character", "is there a wave animation", "add a lamp model to my page"). Free: no account, no API key, no payment. Check here BEFORE generating a model from scratch.
+description: >-
+ Search thousands of ready-made 3D assets on three.ws (CC0 props and objects, rigged humanoid characters, motion clips) and get paste-ready code or a downloaded file. Use when you or the user need a 3D model, prop, object, character, or animation for a scene, site, game, or app ("I need a 3D chair", "find a rigged character", "is there a wave animation", "add a lamp model to my page"). Free: no account, no API key, no payment. Check here BEFORE generating a model from scratch.
when_to_use: Something needs a 3D asset and a ready-made one would do. If the catalog has no match, fall through to generate-3d-model (props) or create-3d-avatar (characters). To put an asset you already have on a page, use embed-three-ws-avatar.
license: MIT
metadata:
category: 3d/creative
- cross-platform-safe: true
+ cross-platform-safe: "true"
pack: three-ws-skills
---
diff --git a/public/skills/3d-studio/generate-3d-model/SKILL.md b/public/skills/3d-studio/generate-3d-model/SKILL.md
index 00c492089..401d8d78e 100644
--- a/public/skills/3d-studio/generate-3d-model/SKILL.md
+++ b/public/skills/3d-studio/generate-3d-model/SKILL.md
@@ -5,7 +5,7 @@ when_to_use: User wants a 3D object/asset/prop from text. For a posable characte
license: MIT
metadata:
category: 3d/creative
- cross-platform-safe: true
+ cross-platform-safe: "true"
pack: three-ws-skills
---
diff --git a/public/skills/3d-studio/rig-a-model/SKILL.md b/public/skills/3d-studio/rig-a-model/SKILL.md
index 2bb2d5762..2662ab99f 100644
--- a/public/skills/3d-studio/rig-a-model/SKILL.md
+++ b/public/skills/3d-studio/rig-a-model/SKILL.md
@@ -5,7 +5,7 @@ when_to_use: User already has a GLB (a URL) and wants it rigged. To generate a n
license: MIT
metadata:
category: 3d/creative
- cross-platform-safe: true
+ cross-platform-safe: "true"
pack: three-ws-skills
---
diff --git a/public/skills/3d-studio/three-ws-3d-skills.zip b/public/skills/3d-studio/three-ws-3d-skills.zip
index e9d3a0fe4..da2eae404 100644
Binary files a/public/skills/3d-studio/three-ws-3d-skills.zip and b/public/skills/3d-studio/three-ws-3d-skills.zip differ
diff --git a/scripts/build-openai-skills-bundle.mjs b/scripts/build-openai-skills-bundle.mjs
index c1a9e878c..423024ba3 100644
--- a/scripts/build-openai-skills-bundle.mjs
+++ b/scripts/build-openai-skills-bundle.mjs
@@ -39,6 +39,7 @@ import { readFileSync, writeFileSync, mkdirSync, rmSync, existsSync, readdirSync
import { join, resolve, dirname, relative } from 'node:path';
import { fileURLToPath } from 'node:url';
import { execFileSync } from 'node:child_process';
+import YAML from 'yaml';
const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');
const SKILLS_DIR = join(ROOT, '.agents', 'skills');
@@ -59,30 +60,12 @@ const argv = new Set(process.argv.slice(2));
const checkOnly = argv.has('--check');
const offline = argv.has('--offline') || checkOnly;
-/** Minimal frontmatter reader: the same subset build-skills-pack.mjs relies on. */
+/** Real YAML parse, so quoted values and folded blocks read as the spec defines them. */
function frontmatter(text) {
const m = text.match(/^---\n([\s\S]*?)\n---\n/);
if (!m) return null;
- const out = {};
- let section = null;
- for (const line of m[1].split('\n')) {
- if (!line.trim() || line.trimStart().startsWith('#')) continue;
- const nested = line.match(/^ {2}([A-Za-z0-9_-]+):\s*(.*)$/);
- if (nested && section) {
- out[section][nested[1]] = nested[2].trim();
- continue;
- }
- const top = line.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
- if (!top) continue;
- if (top[2].trim() === '') {
- section = top[1];
- out[section] = {};
- } else {
- section = null;
- out[top[1]] = top[2].trim();
- }
- }
- return out;
+ const parsed = YAML.parse(m[1]);
+ return parsed && typeof parsed === 'object' ? parsed : null;
}
/**
diff --git a/scripts/build-standalone-skill-repos.mjs b/scripts/build-standalone-skill-repos.mjs
index 2845e2e4c..d08040ce0 100644
--- a/scripts/build-standalone-skill-repos.mjs
+++ b/scripts/build-standalone-skill-repos.mjs
@@ -178,7 +178,9 @@ function main() {
);
console.log('');
}
- console.log(`Users then install with:\n /plugin marketplace add ${OWNER}/${built[0].spec.repo}`);
+ console.log(
+ `Users then install with:\n npx skills add ${OWNER}/${built[0].spec.repo}\n /plugin marketplace add ${OWNER}/${built[0].spec.repo}`,
+ );
}
// ── helpers ────────────────────────────────────────────────────────────────
@@ -260,7 +262,14 @@ deciding to load it.
## Install
-In Claude Code:
+Any agent runtime that reads the open Agent Skills layout (Claude Code, Codex, Cursor and
+others), one command:
+
+\`\`\`bash
+npx skills add ${OWNER}/${spec.repo}
+\`\`\`
+
+In Claude Code, as a plugin:
\`\`\`
/plugin marketplace add ${OWNER}/${spec.repo}
diff --git a/scripts/test-skills-install.mjs b/scripts/test-skills-install.mjs
new file mode 100644
index 000000000..ac59cc955
--- /dev/null
+++ b/scripts/test-skills-install.mjs
@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+// Install test for the standalone skill repos: builds each repo from
+// .agents/skills/, runs the open-standard installer (`npx skills add`) against the
+// staged directory inside a clean temporary project, and verifies that every skill
+// the repo promises landed as <project>/.claude/skills/<name>/SKILL.md and that
+// the installer's own listing finds the same set. Nothing is pushed or published;
+// the installer reads the local directory.
+//
+// Usage: node scripts/test-skills-install.mjs [--only <repo>] [--installer [email protected]]
+// Needs network access for `npx` to fetch the installer. Exit 1 on any mismatch.
+
+import { spawnSync } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import process from 'node:process';
+import { fileURLToPath } from 'node:url';
+
+import { collectSkills } from './build-skills-pack.mjs';
+import { REPO_SPECS } from './build-standalone-skill-repos.mjs';
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const argv = process.argv.slice(2);
+const valueOf = (flag) => (argv.includes(flag) ? argv[argv.indexOf(flag) + 1] : null);
+const INSTALLER = valueOf('--installer') || '[email protected]';
+const only = valueOf('--only');
+
+function run(cmd, args, opts) {
+ const r = spawnSync(cmd, args, { encoding: 'utf8', timeout: 240_000, ...opts });
+ if (r.status !== 0) {
+ throw new Error(`${cmd} ${args.join(' ')} exited ${r.status}\n${r.stdout}\n${r.stderr}`);
+ }
+ return r.stdout;
+}
+
+const work = fs.mkdtempSync(path.join(os.tmpdir(), 'skills-install-'));
+const stage = path.join(work, 'repos');
+const allSkills = collectSkills();
+let failed = false;
+
+try {
+ run('node', [path.join(ROOT, 'scripts', 'build-standalone-skill-repos.mjs'), '--out', stage], { cwd: ROOT });
+ for (const spec of REPO_SPECS.filter((s) => !only || s.repo === only)) {
+ const expected = allSkills.filter(spec.select).map((s) => s.name).sort();
+ const project = path.join(work, `project-${spec.repo}`);
+ fs.mkdirSync(project);
+ const home = path.join(work, `home-${spec.repo}`);
+ fs.mkdirSync(home);
+ const env = { ...process.env, HOME: home, CI: '1', DISABLE_TELEMETRY: '1' };
+ const repoDir = path.join(stage, spec.repo);
+
+ const listing = run('npx', ['-y', INSTALLER, 'add', repoDir, '--list'], { cwd: project, env });
+ const plain = listing.replace(/\u001b\[[0-9;]*m/g, '');
+ const listed = expected.filter((n) => new RegExp(`^\\W*${n}\\s*$`, 'm').test(plain));
+ run('npx', ['-y', INSTALLER, 'add', repoDir, '--skill', '*', '-a', 'claude-code', '-y'], { cwd: project, env });
+
+ const skillsDir = path.join(project, '.claude', 'skills');
+ const installed = fs.existsSync(skillsDir)
+ ? fs.readdirSync(skillsDir).filter((n) => fs.existsSync(path.join(skillsDir, n, 'SKILL.md'))).sort()
+ : [];
+ const missingInstalled = expected.filter((n) => !installed.includes(n));
+ const extra = installed.filter((n) => !expected.includes(n));
+ const missingListed = expected.filter((n) => !listed.includes(n));
+ const ok = !missingInstalled.length && !extra.length && !missingListed.length;
+ failed ||= !ok;
+ console.log(`${ok ? 'ok ' : 'FAIL'} ${spec.repo}: listed ${listed.length}/${expected.length}, installed ${installed.length}/${expected.length}`);
+ console.log(` ${installed.join(', ')}`);
+ if (missingListed.length) console.log(` not listed by installer: ${missingListed.join(', ')}`);
+ if (missingInstalled.length) console.log(` not installed: ${missingInstalled.join(', ')}`);
+ if (extra.length) console.log(` unexpected: ${extra.join(', ')}`);
+ }
+} catch (err) {
+ console.error(err.message);
+ failed = true;
+} finally {
+ fs.rmSync(work, { recursive: true, force: true });
+}
+process.exit(failed ? 1 : 0);
diff --git a/scripts/validate-agent-skills.mjs b/scripts/validate-agent-skills.mjs
new file mode 100644
index 000000000..9fd409327
--- /dev/null
+++ b/scripts/validate-agent-skills.mjs
@@ -0,0 +1,124 @@
+#!/usr/bin/env node
+// Validates every skill folder under .agents/skills/ against the Agent Skills
+// specification (https://agentskills.io/specification): a SKILL.md whose YAML
+// frontmatter carries a `name` that equals the folder name (1-64 chars, lowercase
+// letters, digits and single hyphens) and a `description` (1-1024 chars), plus the
+// optional `license`, `compatibility` (<=500 chars), `metadata` (string to string
+// map) and `allowed-tools` fields. The Claude Code extension fields three.ws
+// skills use (when_to_use, disable-model-invocation, user-invocable) are accepted;
+// anything else is an error, so a typo'd field cannot ship silently. SKILL.md body
+// size is checked against the spec's 500-line guidance.
+//
+// Usage: node scripts/validate-agent-skills.mjs [--dir <skills dir>] [--json]
+// Exit 1 when any three.ws-authored skill fails.
+
+import fs from 'node:fs';
+import path from 'node:path';
+import process from 'node:process';
+import { fileURLToPath } from 'node:url';
+import YAML from 'yaml';
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+
+const SPEC_FIELDS = new Set(['name', 'description', 'license', 'compatibility', 'metadata', 'allowed-tools']);
+const CLAUDE_EXTENSION_FIELDS = new Set(['when_to_use', 'disable-model-invocation', 'user-invocable']);
+const NAME_RE = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+const MAX_BODY_LINES = 500;
+// Vendored partner drops stay byte-identical to their publishers and never ship in
+// the standalone skill repos, so their findings are reported but do not fail the run.
+const VENDORED_RE = /^(okx|metamask)-/;
+
+/** Returns the list of problems for one skill folder (empty when it conforms). */
+export function validateSkillDir(dir) {
+ const folder = path.basename(dir);
+ const problems = [];
+ const file = path.join(dir, 'SKILL.md');
+ if (!fs.existsSync(file)) return ['missing SKILL.md'];
+
+ const text = fs.readFileSync(file, 'utf8');
+ const m = text.match(/^---\r?\n([\s\S]*?)\r?\n---[ \t]*(?:\r?\n|$)/);
+ if (!m) return ['SKILL.md has no YAML frontmatter block'];
+
+ let fm;
+ try {
+ fm = YAML.parse(m[1]);
+ } catch (err) {
+ return [`frontmatter is not valid YAML: ${err.message.split('\n')[0]}`];
+ }
+ if (!fm || typeof fm !== 'object' || Array.isArray(fm)) return ['frontmatter is not a mapping'];
+
+ for (const key of Object.keys(fm)) {
+ if (!SPEC_FIELDS.has(key) && !CLAUDE_EXTENSION_FIELDS.has(key)) {
+ problems.push(`unknown frontmatter field "${key}"`);
+ }
+ }
+
+ if (typeof fm.name !== 'string' || !fm.name) problems.push('name is required');
+ else {
+ if (fm.name.length > 64) problems.push(`name is ${fm.name.length} chars (max 64)`);
+ if (!NAME_RE.test(fm.name)) problems.push(`name "${fm.name}" must be lowercase letters, digits and single hyphens`);
+ if (fm.name !== folder) problems.push(`name "${fm.name}" does not match folder "${folder}"`);
+ }
+
+ if (typeof fm.description !== 'string' || !fm.description.trim()) problems.push('description is required');
+ else if (fm.description.length > 1024) problems.push(`description is ${fm.description.length} chars (max 1024)`);
+
+ if (fm.license !== undefined && (typeof fm.license !== 'string' || !fm.license.trim())) {
+ problems.push('license must be a non-empty string');
+ }
+ if (fm.compatibility !== undefined) {
+ if (typeof fm.compatibility !== 'string' || !fm.compatibility.trim()) problems.push('compatibility must be a non-empty string');
+ else if (fm.compatibility.length > 500) problems.push(`compatibility is ${fm.compatibility.length} chars (max 500)`);
+ }
+ if (fm.metadata !== undefined) {
+ if (!fm.metadata || typeof fm.metadata !== 'object' || Array.isArray(fm.metadata)) problems.push('metadata must be a map');
+ else {
+ for (const [k, v] of Object.entries(fm.metadata)) {
+ if (typeof v !== 'string') problems.push(`metadata.${k} must be a string (got ${typeof v})`);
+ }
+ }
+ }
+ if (fm['allowed-tools'] !== undefined && typeof fm['allowed-tools'] !== 'string') {
+ problems.push('allowed-tools must be a space-separated string');
+ }
+
+ const bodyLines = text.slice(m[0].length).split(/\r?\n/).length;
+ if (bodyLines > MAX_BODY_LINES) problems.push(`SKILL.md body is ${bodyLines} lines (guidance: under ${MAX_BODY_LINES})`);
+ return problems;
+}
+
+export function validateSkillsRoot(root) {
+ const results = [];
+ for (const entry of fs.readdirSync(root, { withFileTypes: true })) {
+ if (!entry.isDirectory()) continue;
+ results.push({
+ skill: entry.name,
+ vendored: VENDORED_RE.test(entry.name),
+ problems: validateSkillDir(path.join(root, entry.name)),
+ });
+ }
+ return results.sort((a, b) => a.skill.localeCompare(b.skill));
+}
+
+const invokedDirectly =
+ process.argv[1] && path.resolve(process.argv[1]) === path.resolve(fileURLToPath(import.meta.url));
+if (invokedDirectly) {
+ const argv = process.argv.slice(2);
+ const i = argv.indexOf('--dir');
+ const root = path.resolve(ROOT, i >= 0 ? argv[i + 1] : path.join('.agents', 'skills'));
+ const results = validateSkillsRoot(root);
+ const failed = results.filter((r) => r.problems.length && !r.vendored);
+ const warned = results.filter((r) => r.problems.length && r.vendored);
+ if (argv.includes('--json')) console.log(JSON.stringify(results, null, '\t'));
+ else {
+ for (const r of results) {
+ console.log(`${!r.problems.length ? 'ok ' : r.vendored ? 'warn' : 'FAIL'} ${r.skill}`);
+ for (const p of r.problems) console.log(` ${p}`);
+ }
+ const own = results.filter((r) => !r.vendored);
+ console.log(
+ `\n${own.length - failed.length}/${own.length} three.ws skills conform to the Agent Skills spec. ${warned.length} vendored partner skills have findings and are left byte-identical.`,
+ );
+ }
+ process.exit(failed.length ? 1 : 0);
+}
diff --git a/tests/agent-skills-spec.test.js b/tests/agent-skills-spec.test.js
new file mode 100644
index 000000000..6a1e0725c
--- /dev/null
+++ b/tests/agent-skills-spec.test.js
@@ -0,0 +1,64 @@
+// Every three.ws-authored skill must conform to the Agent Skills open standard, or
+// the one-command installer (`npx skills add`) and other runtimes skip it or reject
+// its frontmatter. The validator is also exercised on deliberately broken folders so
+// a loosened rule cannot pass unnoticed.
+import { describe, it, expect } from 'vitest';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+
+import { validateSkillDir, validateSkillsRoot } from '../scripts/validate-agent-skills.mjs';
+
+const ROOT = path.resolve(import.meta.dirname, '..');
+
+function makeSkill(folder, frontmatter, body = '# Body\n') {
+ const root = fs.mkdtempSync(path.join(os.tmpdir(), 'skill-spec-'));
+ const dir = path.join(root, folder);
+ fs.mkdirSync(dir);
+ fs.writeFileSync(path.join(dir, 'SKILL.md'), `---\n${frontmatter}\n---\n\n${body}`);
+ return { root, dir };
+}
+
+describe('Agent Skills spec conformance', () => {
+ it('every three.ws-authored skill under .agents/skills conforms', () => {
+ const results = validateSkillsRoot(path.join(ROOT, '.agents', 'skills')).filter((r) => !r.vendored);
+ expect(results.length).toBeGreaterThan(0);
+ expect(results.filter((r) => r.problems.length)).toEqual([]);
+ });
+
+ it('accepts a minimal valid skill', () => {
+ const { dir } = makeSkill('good-skill', 'name: good-skill\ndescription: Does a thing. Use when asked.');
+ expect(validateSkillDir(dir)).toEqual([]);
+ });
+
+ it('rejects a name that differs from the folder', () => {
+ const { dir } = makeSkill('folder-name', 'name: other-name\ndescription: x');
+ expect(validateSkillDir(dir).join()).toMatch(/does not match folder/);
+ });
+
+ it('rejects uppercase and consecutive hyphens in the name', () => {
+ const a = makeSkill('Bad', 'name: Bad\ndescription: x');
+ const b = makeSkill('a--b', 'name: a--b\ndescription: x');
+ expect(validateSkillDir(a.dir).join()).toMatch(/lowercase/);
+ expect(validateSkillDir(b.dir).join()).toMatch(/lowercase/);
+ });
+
+ it('rejects frontmatter that is not valid YAML (unquoted colon in a description)', () => {
+ const { dir } = makeSkill('colon', 'name: colon\ndescription: Use when the user says: do it');
+ expect(validateSkillDir(dir).join()).toMatch(/not valid YAML/);
+ });
+
+ it('rejects non-string metadata values and an over-long description', () => {
+ const a = makeSkill('meta', 'name: meta\ndescription: x\nmetadata:\n flag: true');
+ const b = makeSkill('long', `name: long\ndescription: ${'x'.repeat(1025)}`);
+ expect(validateSkillDir(a.dir).join()).toMatch(/metadata\.flag must be a string/);
+ expect(validateSkillDir(b.dir).join()).toMatch(/max 1024/);
+ });
+
+ it('rejects unknown fields and a list-valued allowed-tools', () => {
+ const { dir } = makeSkill('extra', 'name: extra\ndescription: x\ntitle: nope\nallowed-tools: ["Bash(ls)"]');
+ const out = validateSkillDir(dir).join();
+ expect(out).toMatch(/unknown frontmatter field "title"/);
+ expect(out).toMatch(/allowed-tools must be/);
+ });
+});