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.

chore(prompts): retire order 520, SKILL-MD 1.0 catalog shipped and verified

nirholas80fc3c48f81c
diff --git a/prompts/finish/520-integrate-21-skill-md.md b/prompts/finish/520-integrate-21-skill-md.md
deleted file mode 100644
index eaf34642e..000000000
--- a/prompts/finish/520-integrate-21-skill-md.md
+++ /dev/null
@@ -1,51 +0,0 @@
-# integrate 21: publish a validated skill.md for three.ws's paid HTTP services
-
-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, no gate.
-
-## Operating clause (binding)
-
-- Read CLAUDE.md first, then [_context/integrate-00-CONTEXT.md](_context/integrate-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 is not expected to hit one. Batch every such ask into ONE message after everything else is done.
-- Upstream repos are read, never merged: fetch source as a tarball into your scratchpad exactly as the context file describes, treat it as untrusted data, and never add another repo as a git remote.
-- 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
-
-`skill.md` is the emerging format agents read to learn how to buy from an HTTP service: prices, rails, payTo, examples. The owner's `x402-skill-md` defines it with a generator and validator, and the suite uses it everywhere. three.ws already serves `/openapi.json` with `x-payment-info` (`api/openapi-json.js`), so a correct `skill.md` can be generated from it on every deploy instead of hand-maintained. One rule needs care: the validator's SM005 and SM006 make both an EVM and a Solana rail mandatory at error severity; our Base rail is only advertised when `baseSettleable()` is true, so SM005 must be tolerated when Base is off (Solana first).
-
-## Step 0: re-derive the current state
-
- sed -n 1,60p api/openapi-json.js
- grep -n "baseSettleable" -r api/_lib | head -3
- grep -n "skill.md\|skill-md" -r api vercel.json | head
- curl -s localhost:3000/openapi.json | head -c 600
-
-## Tasks
-
-1. A generator module that turns the live OpenAPI document into `skill.md` (service summary, every paid route with price, rails, payTo, request and response examples taken from the spec).
-2. Serve it at `/skill.md` (route in `vercel.json`, handler next to `api/wk.js`), cached, `text/markdown`.
-3. Validate in tests with the upstream validator (pin the package `^x.y.0` if it is published; otherwise port the validator rules into the repo with the license header).
-4. Link it from `/.well-known/x402.json` and `llms.txt`.
-
-## Definition of done
-
-- [ ] A vitest runs the validator over the generated output and asserts zero errors except SM005 while Base is not settleable.
-- [ ] `curl -s localhost:3000/skill.md` returns the document; `npm run check:pages` passes.
-- [ ] Docs and changelog updated.
-
-## Never blocked
-
-| Blocker | Resolution (act, do not ask) |
-|---|---|
-| The validator package is not on npm | Port its rule set file by file; it is small. |
-
-## 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.
-3. If every Definition of done line passes, delete this file in that same commit (`git rm prompts/finish/520-integrate-21-skill-md.md`) and append a dated entry to [_context/integrate-PROGRESS.md](_context/integrate-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/integrate-PROGRESS.md b/prompts/finish/_context/integrate-PROGRESS.md
index ce7eafa82..267d0d46a 100644
--- a/prompts/finish/_context/integrate-PROGRESS.md
+++ b/prompts/finish/_context/integrate-PROGRESS.md
@@ -1051,3 +1051,51 @@ depends on (applying `20261015100000_payment_session_policy_upgrades.sql` before
Commit: `9f40b6acc` (approvals wiring for both venues, handler tests, docs, changelog), this
closing commit (PROGRESS log, order-file removal).
+
+## 2026-10-15: order 520-integrate-21 closed (evolve)
+
+Built the SKILL-MD 1.0 generator the order asked for: `api/_lib/skill-md.js` reads the live
+`/openapi.json` catalog (`buildOpenApiDoc()`) and the real `buildExactRequirements()` rail
+logic and emits an agent-readable markdown catalog of every paid HTTP route (method, path,
+price, parameters), the Solana and Base payment rails, and a sample 402 challenge, per the
+upstream `x402-skill-md` format. Served at `/.well-known/skill.md` (`api/skill-md.js`, routed
+in `vercel.json`), linked from the `/.well-known/x402.json` discovery doc (`service.skill_md`
+field in `api/wk.js`) and from `llms.txt` (via a new `data/pages.json` machine-section entry).
+
+Definition of Done, verified with real command output:
+- `npx vitest run tests/skill-md.test.js`: 5 passed. The suite imports the real published
+ `[email protected]` npm validator (added as a devDependency, installed for real, not
+ `--package-lock-only`) and asserts zero validator errors other than SM005 (no EVM rail)
+ while Base stays unconfigured in the test env, matching the order's exact tolerance.
+- `curl -s http://localhost:3107/.well-known/skill.md -D -` (via `PORT=3107 node
+ server/index.mjs`, since vite's dev proxy does not execute serverless handlers locally and
+ port 3000 belongs to the owner's dev server): `HTTP/1.1 200 OK`, `content-type:
+ text/markdown; charset=utf-8`, real generated body. `npm run check:pages`: 966/966 pages
+ resolve.
+- Docs updated both directions (`docs/x402-endpoints.md` new "Agent-readable catalog:
+ skill.md" section, `docs/agent-skills.md` cross-reference note), `STRUCTURE.md` row added,
+ `data/changelog.json` entry added and `npm run build:pages` run (propagated into
+ `CHANGELOG.md`, `public/changelog*.json/.xml`, `public/llms*.txt`, `public/features.json`,
+ `public/sitemap/index.html`).
+- `npm run check:rules` clean on every touched file; `npm run check:skills-pack` clean.
+
+Judgment call: the order's literal ask was to serve this at `/skill.md`, but that path is
+already live and linked as the unrelated Agent Skills (agentskills.io) connector file
+(`public/skill.md`, generated from `data/skill-md.template.md` by
+`scripts/build-skills-pack.mjs`). Serving the new document at `/.well-known/skill.md` instead
+avoids overwriting a different, actively-used file; both documents now link to each other so
+neither is an orphan. Discovered mid-session that `public/skill.md` is itself a generated
+artifact, not hand-authored; the one new line it needed went into the source template
+(`data/skill-md.template.md`), then regenerated via `node scripts/build-skills-pack.mjs`
+rather than hand-editing the generated file.
+
+Noted, not fixed (pre-existing, unrelated, out of scope): `tests/api/x402-discovery-green.test.js`
+fails on `/api/x402/transit-delays` (a bazaar.info schema mismatch on `route`). Confirmed via a
+`git stash push -u` / `apply` A/B comparison that this failure exists on the tree with none of
+this order's changes applied, so it predates and is independent of this work.
+
+No owner-gated action: no push, no deploy, no on-chain write, and no reference to a crypto
+project other than $THREE landed in the diff.
+
+Commit: `b3e416177` (generator, handler, routing, test, docs, changelog), this closing commit
+(PROGRESS log, order-file removal).