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.

fix(skills): restore the skills pack files and changelog entry the perps commit overwrote from a stale index

nirholasd553a251f40f
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 4ee427da3..8856a1509 100644
--- a/STRUCTURE.md
+++ b/STRUCTURE.md
@@ -309,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 6987601ad..00c48608d 100644
--- a/data/changelog.json
+++ b/data/changelog.json
@@ -1,6 +1,16 @@
{
"$comment": "Curated changelog entries for three.ws, the editorial layer of the public changelog. New PAGE launches are tracked automatically via the `added` field in data/pages.json; this file is for everything else holders care about: improvements, fixes, SDK releases, trading/payments capabilities, security work. scripts/build-page-index.mjs merges both sources into CHANGELOG.md, public/changelog.json, and public/changelog.xml. Newest first. Allowed tags: feature, improvement, fix, sdk, infra, docs, security, desktop (desktop entries become the desktop app's release notes). `link` is optional and must be a live three.ws path.",
"entries": [
+ {
+ "date": "2026-10-24",
+ "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",
+ "docs"
+ ],
+ "link": "/docs/agent-skills"
+ },
{
"date": "2026-10-24",
"title": "Opt-in WebGPU renderer with automatic WebGL2 fallback, starting in Restyle Studio",
diff --git a/data/pages.json b/data/pages.json
index 963d3cd91..df4cfc4a9 100644
--- a/data/pages.json
+++ b/data/pages.json
@@ -5774,6 +5774,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/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/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/);
+ });
+});