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.

docs(announce): draft the Open Source Friday approval post against a captured Rig Doctor frame

nirholas15af54f06254
diff --git a/data/announce-media.json b/data/announce-media.json
index 70a69e135..925a4070b 100644
--- a/data/announce-media.json
+++ b/data/announce-media.json
@@ -20,7 +20,10 @@
"alt": "Animated loop of the three.ws Agent Activity feed updating in real time as autonomous agents score and trade pump.fun launches",
"caption": "Not a mock-up: the feed captured while it streamed.",
"settle": 9000,
- "motion": { "seconds": 5, "fps": 12 }
+ "motion": {
+ "seconds": 5,
+ "fps": 12
+ }
},
{
"id": "genesis-hero",
@@ -29,7 +32,9 @@
"alt": "The three.ws Genesis page signed in: describe an agent, upload a selfie, or remix a public avatar, and it becomes a rigged 3D agent with its own wallet and on-chain identity",
"caption": "Genesis, signed in: three ways to start, one minute to an owned agent.",
"auth": true,
- "hide": ["#home-nav-user"]
+ "hide": [
+ "#home-nav-user"
+ ]
},
{
"id": "three-token-hero",
@@ -45,7 +50,17 @@
"alt": "Animated loop of live $THREE trades streaming onto the three.ws token page",
"caption": "The trade feed, captured live.",
"settle": 9000,
- "motion": { "seconds": 5, "fps": 12 }
+ "motion": {
+ "seconds": 5,
+ "fps": 12
+ }
+ },
+ {
+ "id": "rig-doctor-hero",
+ "surface": "/rig-doctor",
+ "url": "/rig-doctor",
+ "alt": "three.ws Rig Doctor: drop in any humanoid GLB and it names the skeleton convention, then lists joint by joint which bones will animate and which will not move",
+ "caption": "Rig Doctor tells you which joints will not move before you ever load a clip."
}
]
}
diff --git a/docs/announcements/README.md b/docs/announcements/README.md
index 2e50a870a..6d55eda4d 100644
--- a/docs/announcements/README.md
+++ b/docs/announcements/README.md
@@ -59,3 +59,4 @@ node scripts/post-tweet.mjs --file docs/announcements/<slug>.post.txt --dry-run
| Pack | Surface | Stage |
|---|---|---|
| [genesis.md](./genesis.md) | [`/genesis`](https://three.ws/genesis) | drafted, awaiting approval to post |
+| [open-source-friday.md](./open-source-friday.md) | [`/rig-doctor`](https://three.ws/rig-doctor) | drafted, awaiting approval to post |
diff --git a/docs/announcements/open-source-friday.md b/docs/announcements/open-source-friday.md
new file mode 100644
index 000000000..4649ee46d
--- /dev/null
+++ b/docs/announcements/open-source-friday.md
@@ -0,0 +1,67 @@
+# Announcement pack: approved for Open Source Friday
+
+**Surface:** [`/rig-doctor`](https://three.ws/rig-doctor) · **Ledger key:** `/rig-doctor` · **Stage:** drafted
+· **Approved:** 2026-09-04 ([open-source-friday#254](https://github.com/githubevents/open-source-friday/issues/254) carries the `approved` label)
+· **Announced externally:** never
+
+Written against [the announcement voice](../announce-voice.md). This is the beat the
+[stream plan](../open-source-friday-plan.md) does not have: its sequence runs T-14 application,
+T-7 ask, T-1 reminder, T-0 live, T+1 replay, all anchored to a stream date that is not booked yet.
+Approval is its own news and it is public the moment the label lands, so this post fills the gap
+between the application post and the date post without spending either.
+
+It deliberately is not a "we got approved" brag. Section 5 of the plan measured GitHub's own OSF
+posts at 7.1 average engagement and falling, and found their best-performing non-showcase format
+is a call to action with a deadline. So the approval is the reason, and the ask is the post: claim
+a first issue now and it gets merged on air.
+
+---
+
+## The claim, and where it is checked
+
+> Rig Doctor recognises 11 rig conventions. Teaching it a 12th is an open first issue, and it
+> gets merged live on the stream.
+
+| Part of the claim | Where it is real |
+|---|---|
+| Approved for Open Source Friday | The `approved` label on [issue #254](https://github.com/githubevents/open-source-friday/issues/254) |
+| 11 rig conventions | On screen in the captured frame, from `CONVENTIONS` in [`src/rig-report.js`](../../src/rig-report.js). This is the fingerprint list, which is a narrower thing than the 19 name-variant families [`src/glb-canonicalize.js`](../../src/glb-canonicalize.js) can map. The post cites the on-screen number, per voice rule 3. |
+| Teaching it a 12th is an open first issue | [#110](https://github.com/nirholas/three.ws/issues/110) (Apple / ARKit `_joint`), [#111](https://github.com/nirholas/three.ws/issues/111) (Kinect trailing-side), [#112](https://github.com/nirholas/three.ws/issues/112) (Reallusion numbered spine), all open and labelled `good first issue`, each naming its file and verification command |
+| We merge it live | The owner is the reviewer on this repo, so a PR opened on stream can be reviewed and merged on stream. This is section 4 of the runsheet. |
+
+The 0-of-10-joints framing belongs to #110 and #111 only. #112 is a two-joint spine gap on an
+otherwise-mapped skeleton, so do not describe it as a convention that maps nothing.
+
+## Media
+
+Captured from the live route by `npm run announce:media`. Provenance (route, commit, time, sha256)
+is in [`public/announce/media-manifest.json`](../../public/announce/media-manifest.json).
+
+| Shot | File | Notes |
+|---|---|---|
+| `rig-doctor-hero` | `/announce/img/rig-doctor-hero.webp` | 1800x1013. The headline asks the question the post answers, and the stat bar carries the 11 the post cites. |
+
+**Alt text, required on the post:**
+
+> three.ws Rig Doctor: drop in any humanoid GLB and it names the skeleton convention, then lists
+> joint by joint which bones will animate and which will not move.
+
+## The post
+
+The bytes that ship are [`open-source-friday.post.txt`](./open-source-friday.post.txt), 175
+weighted characters, inside the 100 to 179 band that measures 3.0x on the archive.
+
+## Do not
+
+- **Do not name a stream date.** None is booked. The date is a separate post, and it is the one
+ that carries the Twitch link and the time in ET.
+- **Do not tag @github or the program maintainers.** They have not scheduled us yet, and the
+ plan's read is that their announcement is weak anyway. Reach comes from our side.
+- **Do not claim a convention count above 11 in the post.** The frame says 11. A number the image
+ does not support fails voice rule 3 even when a source file agrees with it.
+
+## After it is posted
+
+The next beat is the date, which needs the booking at https://gh.io/osf-booking and a reply on
+[#254](https://github.com/githubevents/open-source-friday/issues/254) saying which Friday was
+taken. Then the plan's T-7, T-1, T-0 and T+1 posts run as written.
diff --git a/docs/announcements/open-source-friday.post.txt b/docs/announcements/open-source-friday.post.txt
new file mode 100644
index 000000000..8313537ed
--- /dev/null
+++ b/docs/announcements/open-source-friday.post.txt
@@ -0,0 +1 @@
+Approved for GitHub's Open Source Friday. Rig Doctor knows 11 rig conventions. Teaching it the 12th is an open first issue, and we merge it live on stream: three.ws/rig-doctor
diff --git a/docs/first-contribution.md b/docs/first-contribution.md
index a77451720..da62bccea 100644
--- a/docs/first-contribution.md
+++ b/docs/first-contribution.md
@@ -134,10 +134,11 @@ describe('MMD (MikuMikuDance) Japanese skeleton', () => {
### Now do one that is actually open
-MMD is done, so do not re-submit it. Pick a convention that still returns `null` and give it the same four-part treatment (alias map, tests, Rig Doctor fingerprint, docs row). Two are verified open and waiting, each with the file, the bones, and the verification command spelled out:
+MMD is done, so do not re-submit it. Pick a convention that still returns `null` and give it the same four-part treatment (alias map, tests, Rig Doctor fingerprint, docs row). Three are verified open and waiting, each with the file, the bones, and the verification command spelled out:
- [#110](https://github.com/nirholas/three.ws/issues/110): Apple / ARKit rigs, which suffix every joint with `_joint` (`hips_joint`, `left_arm_joint`). 0 of 10 joints map today.
- [#111](https://github.com/nirholas/three.ws/issues/111): Kinect rigs, which put the side word last (`ShoulderLeft`, `ElbowLeft`, `SpineBase`). 0 of 10 map today.
+- [#112](https://github.com/nirholas/three.ws/issues/112): Reallusion Character Creator 3/4, whose numbered spine chain (`CC_Base_Spine01`, `CC_Base_Spine02`) returns `null` while the rest of the CC skeleton already maps. A smaller gap than the other two, and a good first one if you want the shape of the change without the full ten joints.
Comment on the one you are taking, then:
diff --git a/public/announce/img/rig-doctor-hero.webp b/public/announce/img/rig-doctor-hero.webp
new file mode 100644
index 000000000..fc46d7b49
Binary files /dev/null and b/public/announce/img/rig-doctor-hero.webp differ
diff --git a/public/announce/media-manifest.json b/public/announce/media-manifest.json
index e919cfc7c..391327b2a 100644
--- a/public/announce/media-manifest.json
+++ b/public/announce/media-manifest.json
@@ -1,6 +1,6 @@
{
"generatedBy": "scripts/capture-doc-media.mjs",
- "generatedAt": "2026-09-04T18:17:41.963Z",
+ "generatedAt": "2026-09-04T18:29:12.207Z",
"shots": {
"activity-hero": {
"id": "activity-hero",
@@ -58,6 +58,23 @@
"width": 1800,
"height": 1013
},
+ "rig-doctor-hero": {
+ "id": "rig-doctor-hero",
+ "src": "/announce/img/rig-doctor-hero.webp",
+ "alt": "three.ws Rig Doctor: drop in any humanoid GLB and it names the skeleton convention, then lists joint by joint which bones will animate and which will not move",
+ "caption": "Rig Doctor tells you which joints will not move before you ever load a clip.",
+ "route": "/rig-doctor",
+ "viewport": "wide",
+ "animated": false,
+ "authenticated": false,
+ "capturedAt": "2026-09-04T18:29:11.891Z",
+ "capturedFrom": "https://three.ws",
+ "commit": "0733340b4",
+ "sha256": "60ef882c910c682b25407775960fca8580756ff7d8402ceca94b4aa76e163981",
+ "bytes": 53084,
+ "width": 1800,
+ "height": 1013
+ },
"three-token-hero": {
"id": "three-token-hero",
"src": "/announce/img/three-token-hero.webp",