@bongos/core 1.20.2 → 1.20.3

package/docs/page-readings.json

@@ -5,7 +5,7 @@
   "adr": "0341 D3",
   "reread": "node scripts/gds/page-reader.js --stale",
   "how": ["Generated by node scripts/gds/page-reader.js (BV2.TW04, task 1004315; ADR 0341 D3). Do not hand-edit.","One entry per page of docs/page-inventory.json. Lines are in page order: the default state first, and a line only another state shows sits where that state shows it, with its state named.","placement: placed = a docs/copy-registry.json row renders it (file, line, string_id); shared = shell text every page of the surface carries (top bar, sidebar, footer), with its row when the registry has one; unplaced = the registry cannot place it (a rewrite becomes an engineer task, ADR 0341 D4).","text keeps {…} where the registry row has a hole, or where a value the page read from its API was filled in. A string that is only such data is counted under omitted.data, not listed.","reading_hash is over the non-shared lines (key, section, text); files_hash is over the page's inventory files. --check compares files_hash only and never opens a browser.","Rendered through the hall-preview harness (hall) and the ui-design kit stub (landing, status), at 1280x800 with the clock pinned, so a reading is the fixture world's page."],
-  "counts": {"pages":39,"lines":3739,"placed":1237,"shared":254,"unplaced":2248,"omitted_data":1941},
+  "counts": {"pages":39,"lines":3779,"placed":1270,"shared":254,"unplaced":2255,"omitted_data":1948},
   "pages": [
     {
       "id": "builders:atlas",
@@ -2452,11 +2452,11 @@
       "id": "builders:settings",
       "surface": "builders",
       "title": "Settings",
-      "states_read": ["account","access","preferences","sound","update"],
-      "files_hash": "0ab819571fc478af",
-      "reading_hash": "c06b8fe2ca8fad7b",
-      "counts": {"lines":117,"placed":77,"shared":5,"unplaced":35},
-      "omitted": {"data":79},
+      "states_read": ["account","access","preferences","skills-walkthrough","sound","update"],
+      "files_hash": "a237c2bc0d4338e7",
+      "reading_hash": "3561d6024edc1678",
+      "counts": {"lines":157,"placed":110,"shared":5,"unplaced":42},
+      "omitted": {"data":86},
       "notes": [],
       "lines": [
         {"key":"L0001","section":"skip link","text":"Skip to content","placement":"shared","file":"modules/hall-ui/public/shell.js","line":767,"string_id":"87cee78ca134"},
@@ -2487,7 +2487,7 @@
         {"key":"L0026","section":"footer","text":"Sign out","placement":"shared","file":"modules/hall-ui/public/shell.js","line":464,"string_id":"1883ad7f07fc","state":"update","occurrences":5},
         {"key":"L0027","section":"Skill voices","text":"Skill voices","placement":"placed","file":"modules/hall-ui/public/settings.html","line":310,"string_id":"ecc12c1dd4de","state":"sound"},
         {"key":"L0028","section":"Skill voices","text":"Each slash-command can run on a different model. The system has a default for every skill; choose another to override it, or leave it on Default.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":311,"string_id":"7f1b1c32d360","state":"sound"},
-        {"key":"L0029","section":"Skill voices","text":"Skill","placement":"unplaced","state":"sound"},
+        {"key":"L0029","section":"Skill voices","text":"Skill","placement":"placed","file":"modules/hall-ui/public/settings-specialities.js","line":128,"string_id":"4b0ca7d7171f","state":"sound"},
         {"key":"L0030","section":"Skill voices","text":"Default","placement":"unplaced","state":"sound"},
         {"key":"L0031","section":"Skill voices","text":"Your choice","placement":"placed","file":"modules/hall-ui/public/settings.html","line":319,"string_id":"f96bc227dba0","state":"sound"},
         {"key":"L0032","section":"Skill voices","text":"no LLM","placement":"unplaced","state":"sound","occurrences":22},
@@ -2511,71 +2511,111 @@
         {"key":"L0050","section":"How Claude talks to you","text":"How Claude talks to you","placement":"placed","file":"modules/hall-ui/public/settings.html","line":193,"string_id":"0469a83cf1e8","state":"preferences"},
         {"key":"L0051","section":"How Claude talks to you","text":"How replies are pitched for you — the vocabulary assumed, how much hand-holding local tooling gets, how long an answer runs, and how much of the work behind it is narrated. These reach every session you start. The defaults assume no software-engineering background; change any of them and the rest stay as they are.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":194,"string_id":"63dbe9873b4e","state":"preferences"},
         {"key":"L0052","section":"How Claude talks to you","text":"{…} file{…}","placement":"placed","file":"modules/hall-ui/public/gate.js","line":151,"string_id":"3efa67dc6e07","state":"preferences"},
-        {"key":"L0053","section":"Wandering","text":"Wandering","placement":"unplaced","state":"preferences"},
-        {"key":"L0054","section":"Wandering","text":"How readily Claude opens a","placement":"placed","file":"modules/hall-ui/public/settings.html","line":275,"string_id":"0bae5deb899d","state":"preferences"},
-        {"key":"L0055","section":"Wandering","text":"new thread","placement":"placed","file":"modules/hall-ui/public/settings.html","line":276,"string_id":"86f235ddfe01","state":"preferences"},
-        {"key":"L0056","section":"Wandering","text":"of work — a tangent, an investigation, an unprompted suggestion — instead of staying on your claimed task. It never limits the work on the task itself. Your rank sets the starting point; newcomers stay locked low.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":276,"string_id":"99f88f2af2ee","state":"preferences"},
-        {"key":"L0057","section":"Wandering","text":"{…} file{…}","placement":"placed","file":"modules/hall-ui/public/gate.js","line":151,"string_id":"3efa67dc6e07","state":"preferences"},
-        {"key":"L0058","section":"Wandering","text":"default for your rank","placement":"placed","file":"modules/hall-ui/public/settings.js","line":420,"string_id":"4a287afb0892","state":"preferences"},
-        {"key":"L0059","section":"Wandering","text":"{…} and {…}","placement":"placed","file":"modules/hall-ui/public/profile-nudge.js","line":77,"string_id":"56b00d773232","state":"preferences"},
-        {"key":"L0060","section":"Wandering","text":"Now: {…}. Your rank allows up to {…}.","placement":"unplaced","state":"preferences"},
-        {"key":"L0061","section":"Rendering","text":"Rendering","placement":"unplaced","state":"preferences"},
-        {"key":"L0062","section":"Rendering","text":"How much your session cards — what","placement":"placed","file":"modules/hall-ui/public/settings.html","line":294,"string_id":"160adde1e398","state":"preferences"},
-        {"key":"L0063","section":"Rendering","text":", claiming, and shipping show — spend on explaining themselves. Richer cards say more and cost more tokens; leaner ones carry the same facts for less. By default this follows how Claude talks to you, so you can set it once in","placement":"placed","file":"modules/hall-ui/public/settings.html","line":295,"string_id":"1f8aceffb15e","state":"preferences"},
-        {"key":"L0064","section":"Rendering","text":"How Claude talks to you","placement":"placed","file":"modules/hall-ui/public/settings.html","line":193,"string_id":"0469a83cf1e8","state":"preferences"},
-        {"key":"L0065","section":"Rendering","text":"and leave this alone.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":299,"string_id":"2177da93be9b","state":"preferences"},
-        {"key":"L0066","section":"Rendering","text":"Session card richness","placement":"placed","file":"modules/hall-ui/public/settings-render.js","line":83,"string_id":"64a1f055129e","state":"preferences"},
-        {"key":"L0067","section":"Rendering","text":"How much the claim and ship cards show. Richer cards explain more and cost more tokens; the confirmation line is always there whichever you pick.","placement":"placed","file":"modules/hall-ui/public/settings-render.js","line":84,"string_id":"d76a5fcbde7c","state":"preferences"},
-        {"key":"L0068","section":"Rendering","text":"Match my interaction profile","placement":"unplaced","state":"preferences"},
-        {"key":"L0069","section":"Rendering","text":"default ({…})","placement":"placed","file":"modules/hall-ui/public/settings-render.js","line":64,"string_id":"4adbb8da9999","state":"preferences"},
-        {"key":"L0070","section":"Rendering","text":"{…} Change that profile and this follows it.","placement":"placed","file":"modules/hall-ui/public/settings-render.js","line":65,"string_id":"de5b58a187c6","state":"preferences"},
-        {"key":"L0071","section":"Rendering","text":"{…} and {…}","placement":"placed","file":"modules/hall-ui/public/profile-nudge.js","line":77,"string_id":"56b00d773232","state":"preferences"},
-        {"key":"L0072","section":"Rendering","text":"Saves the moment you choose; applies from your next session.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":303,"string_id":"72f24fcbe9e0","state":"preferences"},
-        {"key":"L0073","section":"CLI access","text":"CLI access","placement":"placed","file":"modules/hall-ui/public/settings.html","line":133,"string_id":"a015a43bfc7f","state":"access"},
-        {"key":"L0074","section":"CLI access","text":"Mint a fresh CLI token using this browser session and paste it into your terminal — the quick way back in when a","placement":"placed","file":"modules/hall-ui/public/settings.html","line":134,"string_id":"64e91044df43","state":"access"},
-        {"key":"L0075","section":"CLI access","text":"/builder-*","placement":"unplaced","state":"access"},
-        {"key":"L0076","section":"CLI access","text":"command says your session expired.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":136,"string_id":"508ff7083048","state":"access"},
-        {"key":"L0077","section":"CLI access","text":"Re-issue CLI token","placement":"placed","file":"modules/hall-ui/public/settings.html","line":140,"string_id":"e60039795803","state":"access"},
-        {"key":"L0078","section":"CLI access","text":"paste it into your terminal — bypasses Device Flow.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":141,"string_id":"25d2c940e672","state":"access"},
-        {"key":"L0079","section":"CLI access","text":"Tokens refresh on use; re-issuing never signs you out anywhere else.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":144,"string_id":"7dfdc26f9f79","state":"access"},
-        {"key":"L0080","section":"Active sessions","text":"Active sessions","placement":"placed","file":"modules/hall-ui/public/settings.html","line":151,"string_id":"524188fe0078","state":"access"},
-        {"key":"L0081","section":"Active sessions","text":"Every place you are currently signed in — this browser, your terminal, any other machine. A session refreshes for another 24 hours each time it is used, so one you have forgotten about can stay alive indefinitely. If a token has leaked, end it here.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":152,"string_id":"c188854da766","state":"access"},
-        {"key":"L0082","section":"Active sessions","text":"Browser","placement":"unplaced","state":"access"},
-        {"key":"L0083","section":"Active sessions","text":"this session","placement":"placed","file":"modules/hall-ui/public/settings-sessions.js","line":44,"string_id":"632527db5bca","state":"access"},
-        {"key":"L0084","section":"Active sessions","text":"last used {…} · signed in {…}","placement":"placed","file":"modules/hall-ui/public/settings-sessions.js","line":46,"string_id":"9018bf6e99eb","state":"access","occurrences":3},
-        {"key":"L0085","section":"Active sessions","text":"End session","placement":"placed","file":"modules/hall-ui/public/settings-sessions.js","line":46,"string_id":"8d2b4f119ee3","state":"access","occurrences":3},
-        {"key":"L0086","section":"Active sessions","text":"Terminal","placement":"unplaced","state":"access"},
-        {"key":"L0087","section":"Active sessions","text":"Session","placement":"unplaced","state":"access"},
-        {"key":"L0088","section":"Active sessions","text":"Sign out everywhere","placement":"placed","file":"modules/hall-ui/public/settings.html","line":160,"string_id":"8ad669ab2565","state":"access"},
-        {"key":"L0089","section":"Active sessions","text":"ends every session including this one — you will be asked to sign in again.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":161,"string_id":"12a23cc46ace","state":"access"},
-        {"key":"L0090","section":"Active sessions","text":"Ending a session takes effect immediately; the token stops working on its very next request.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":163,"string_id":"8e82771e5b63","state":"access"},
-        {"key":"L0091","section":"Image-generation key","text":"Image-generation key","placement":"placed","file":"modules/hall-ui/public/settings.html","line":173,"string_id":"783853467d52","state":"access","occurrences":2},
-        {"key":"L0092","section":"Image-generation key","text":"The art pipeline draws tiles and sprites with Google AI Studio (Gemini). Needed only if you generate art — your key, your bill, paid only for what you make.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":174,"string_id":"600b90074021","state":"access"},
-        {"key":"L0093","section":"Image-generation key","text":"Your key","placement":"placed","file":"modules/hall-ui/public/settings.js","line":828,"string_id":"51fd6f1ecb2f","state":"access"},
-        {"key":"L0094","section":"Image-generation key","text":"Paste your Google AI Studio key","placement":"unplaced","attr":"placeholder","state":"access"},
-        {"key":"L0095","section":"Image-generation key","text":"Save key","placement":"placed","file":"modules/hall-ui/public/settings.js","line":832,"string_id":"0c79b504aebe","state":"access"},
-        {"key":"L0096","section":"Image-generation key","text":"Get a free key ↗","placement":"placed","file":"modules/hall-ui/public/settings.js","line":800,"string_id":"2ae2114b61db","state":"access"},
-        {"key":"L0097","section":"Image-generation key","text":"· Stored encrypted; never shown again after saving.","placement":"placed","file":"modules/hall-ui/public/settings.js","line":834,"string_id":"b3757ba3bb46","state":"access"},
-        {"key":"L0098","section":"Image-generation key","text":"Stored encrypted; never shown again after saving — only its last four digits.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":182,"string_id":"6c6544f5c011","state":"access"},
-        {"key":"L0099","section":"Connections","text":"Connections","placement":"unplaced"},
-        {"key":"L0100","section":"Connections","text":"Link your Discord account and you're added to the {{worldName}} server with your rank role already set — no invite to share or leak.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":64,"string_id":"64e85f1691f9"},
-        {"key":"L0101","section":"Connections","text":"Discord connected ✓","placement":"placed","file":"modules/hall-ui/public/settings.js","line":676,"string_id":"0f685daf1bd5"},
-        {"key":"L0102","section":"Connections","text":"You're in the {…} server with your rank role.","placement":"placed","file":"modules/hall-ui/public/settings.js","line":677,"string_id":"8e1915b19274"},
-        {"key":"L0103","section":"Connections","text":"Unlink","placement":"unplaced"},
-        {"key":"L0104","section":"Connections","text":"Linking opens Discord's consent screen; unlinking applies at once.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":69,"string_id":"9a31cf5fe05b"},
-        {"key":"L0105","section":"Display name","text":"Display name","placement":"placed","file":"modules/hall-ui/public/settings.html","line":77,"string_id":"3e561393f4e9","occurrences":2},
-        {"key":"L0106","section":"Display name","text":"The name shown beside your work — in the roster, the leaderboard, and the work feed. Your sign-in and the credit for shipped work stay tied to your account, not this label.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":78,"string_id":"82479c539fca"},
-        {"key":"L0107","section":"Display name","text":"Your display name","placement":"placed","file":"modules/hall-ui/public/settings.html","line":87,"string_id":"909b0b7c6ffa","attr":"placeholder"},
-        {"key":"L0108","section":"Display name","text":"Save","placement":"unplaced"},
-        {"key":"L0109","section":"Display name","text":"Saves when you press Save; shows everywhere at once.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":91,"string_id":"e8e4e49fe8f4"},
-        {"key":"L0110","section":"Preferred roles","text":"Preferred roles","placement":"placed","file":"modules/hall-ui/public/settings.html","line":115,"string_id":"e883f2789cae"},
-        {"key":"L0111","section":"Preferred roles","text":"The kinds of work you prefer. Task suggestions lean toward your choices — pick one, several, or none.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":116,"string_id":"9f45c63c9697"},
-        {"key":"L0112","section":"Preferred roles","text":"Artist","placement":"unplaced"},
-        {"key":"L0113","section":"Preferred roles","text":"Ideator","placement":"unplaced"},
-        {"key":"L0114","section":"Preferred roles","text":"UI","placement":"unplaced"},
-        {"key":"L0115","section":"Preferred roles","text":"Save","placement":"unplaced"},
-        {"key":"L0116","section":"Preferred roles","text":"Saves when you press Save; your next","placement":"placed","file":"modules/hall-ui/public/settings.html","line":125,"string_id":"42cbc20a6ec8"},
-        {"key":"L0117","section":"Preferred roles","text":"reflects it.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":125,"string_id":"26da1df6fd4a"}
+        {"key":"L0053","section":"Your specialities","text":"Your specialities","placement":"placed","file":"modules/hall-ui/public/settings.html","line":212,"string_id":"dd419ffd76f0","state":"preferences"},
+        {"key":"L0054","section":"Your specialities","text":"A role says how you work. A speciality says what you work on — and how you, as someone who knows the subject, want to be engaged inside it. Whichever one you are using reaches every session where you hold a claim in that role. Train it by adding things you have written; it also picks things up on its own as you work.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":213,"string_id":"244ea2a3564e","state":"preferences"},
+        {"key":"L0055","section":"Your specialities","text":"Markets, incentives, and how to price them.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":241,"string_id":"8bdec961e84a","state":"preferences"},
+        {"key":"L0056","section":"Your specialities","text":"What this adds to your sessions — written by someone else","placement":"unplaced","state":"preferences"},
+        {"key":"L0057","section":"Your specialities","text":"Argue from mechanism, not vibes. Always name the assumption a number rests on.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":245,"string_id":"d9dd46194f35","state":"preferences"},
+        {"key":"L0058","section":"Your specialities","text":"{…} and {…}","placement":"placed","file":"modules/hall-ui/public/profile-nudge.js","line":77,"string_id":"56b00d773232","state":"preferences","occurrences":2},
+        {"key":"L0059","section":"Your specialities","text":"Trained on","placement":"placed","file":"modules/hall-ui/public/settings-specialities.js","line":220,"string_id":"becc35640e42","state":"preferences"},
+        {"key":"L0060","section":"Your specialities","text":"document{…} you added · learned","placement":"placed","file":"modules/hall-ui/public/settings-specialities.js","line":220,"string_id":"a3fd52d9513b","state":"preferences"},
+        {"key":"L0061","section":"Your specialities","text":"things from your sessions · shared with: Anyone on this instance · offers","placement":"unplaced","state":"preferences"},
+        {"key":"L0062","section":"Your specialities","text":"skills","placement":"unplaced","state":"preferences"},
+        {"key":"L0063","section":"Your specialities","text":"Use this","placement":"placed","file":"modules/hall-ui/public/settings-specialities.js","line":291,"string_id":"e7e2a99a2bea","state":"preferences"},
+        {"key":"L0064","section":"Your specialities","text":"Skill {…} of {…} in {…}","placement":"placed","file":"modules/hall-ui/public/settings-specialities.js","line":128,"string_id":"4b0ca7d7171f","state":"skills-walkthrough"},
+        {"key":"L0065","section":"Your specialities","text":"What it does","placement":"placed","file":"modules/hall-ui/public/settings-specialities.js","line":128,"string_id":"0efa2f18bb6c","state":"skills-walkthrough"},
+        {"key":"L0066","section":"Your specialities","text":"{…} project{…}","placement":"placed","file":"modules/hall-ui/public/fleet.js","line":39,"string_id":"771bef3d31b5","state":"skills-walkthrough"},
+        {"key":"L0067","section":"Your specialities","text":"When to reach for it","placement":"placed","file":"modules/hall-ui/public/settings-specialities.js","line":128,"string_id":"a6e102816e92","state":"skills-walkthrough"},
+        {"key":"L0068","section":"Your specialities","text":"{…} You can also start it yourself by typing","placement":"unplaced","state":"skills-walkthrough"},
+        {"key":"L0069","section":"Your specialities","text":"What it costs","placement":"placed","file":"modules/hall-ui/public/settings-specialities.js","line":128,"string_id":"65fd1339e2f2","state":"skills-walkthrough"},
+        {"key":"L0070","section":"Your specialities","text":"These words come from the skill’s own description, which was written for Claude to recognise rather than for you to read — so a term may go unexplained.","placement":"placed","file":"modules/hall-ui/public/settings-specialities.js","line":126,"string_id":"775a73b066e3","state":"skills-walkthrough"},
+        {"key":"L0071","section":"Your specialities","text":"Leave it off","placement":"placed","file":"modules/hall-ui/public/settings-specialities.js","line":136,"string_id":"6137d2679912","state":"skills-walkthrough"},
+        {"key":"L0072","section":"Your specialities","text":"Turn it on","placement":"placed","file":"modules/hall-ui/public/settings-specialities.js","line":136,"string_id":"26ec8100bc6f","state":"skills-walkthrough"},
+        {"key":"L0073","section":"Your specialities","text":"Finish later — everything stays off until you save","placement":"placed","file":"modules/hall-ui/public/settings-specialities.js","line":178,"string_id":"e8738f535783","state":"skills-walkthrough"},
+        {"key":"L0074","section":"Create one","text":"Create one","placement":"placed","file":"modules/hall-ui/public/settings.html","line":224,"string_id":"20459b66303a","state":"preferences"},
+        {"key":"L0075","section":"Create one","text":"Name","placement":"unplaced","state":"preferences"},
+        {"key":"L0076","section":"Create one","text":"Role it sits under","placement":"placed","file":"modules/hall-ui/public/settings.html","line":230,"string_id":"12af2af5acf2","state":"preferences"},
+        {"key":"L0077","section":"Create one","text":"Pick one…","placement":"placed","file":"modules/hall-ui/public/settings.html","line":232,"string_id":"45378ea261f6","state":"preferences"},
+        {"key":"L0078","section":"Create one","text":"Ideator","placement":"unplaced","state":"preferences"},
+        {"key":"L0079","section":"Create one","text":"Artist","placement":"unplaced","state":"preferences"},
+        {"key":"L0080","section":"Create one","text":"UI design","placement":"placed","file":"modules/hall-ui/public/settings.html","line":236,"string_id":"6516cc82021a","state":"preferences"},
+        {"key":"L0081","section":"Create one","text":"Summary","placement":"unplaced","state":"preferences"},
+        {"key":"L0082","section":"Create one","text":"(optional)","placement":"unplaced","state":"preferences","occurrences":2},
+        {"key":"L0083","section":"Create one","text":"Markets, incentives, and how to price them.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":241,"string_id":"8bdec961e84a","attr":"placeholder","state":"preferences"},
+        {"key":"L0084","section":"Create one","text":"How Claude should engage you in it","placement":"placed","file":"modules/hall-ui/public/settings.html","line":244,"string_id":"6dd3c797943b","state":"preferences"},
+        {"key":"L0085","section":"Create one","text":"Argue from mechanism, not vibes. Always name the assumption a number rests on.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":245,"string_id":"d9dd46194f35","attr":"placeholder","state":"preferences"},
+        {"key":"L0086","section":"Create one","text":"Who can use it","placement":"placed","file":"modules/hall-ui/public/settings.html","line":248,"string_id":"b79ea4077bc5","state":"preferences"},
+        {"key":"L0087","section":"Create one","text":"Only me","placement":"placed","file":"modules/hall-ui/public/settings.html","line":250,"string_id":"45b667751b95","state":"preferences"},
+        {"key":"L0088","section":"Create one","text":"Anyone in the owning project","placement":"placed","file":"modules/hall-ui/public/settings.html","line":251,"string_id":"8832c7204180","state":"preferences"},
+        {"key":"L0089","section":"Create one","text":"Anyone on this instance","placement":"placed","file":"modules/hall-ui/public/settings.html","line":252,"string_id":"7d2ab55d4112","state":"preferences"},
+        {"key":"L0090","section":"Create one","text":"May be offered for sale later","placement":"placed","file":"modules/hall-ui/public/settings.html","line":257,"string_id":"6e73716aec6c","state":"preferences"},
+        {"key":"L0091","section":"Create one","text":"Records your decision only — there is no marketplace yet, and nothing is listed anywhere.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":259,"string_id":"b40c4a61070e","state":"preferences"},
+        {"key":"L0092","section":"Create one","text":"Create speciality","placement":"placed","file":"modules/hall-ui/public/settings.html","line":263,"string_id":"af21de422c14","state":"preferences"},
+        {"key":"L0093","section":"Wandering","text":"Wandering","placement":"unplaced","state":"preferences"},
+        {"key":"L0094","section":"Wandering","text":"How readily Claude opens a","placement":"placed","file":"modules/hall-ui/public/settings.html","line":275,"string_id":"0bae5deb899d","state":"preferences"},
+        {"key":"L0095","section":"Wandering","text":"new thread","placement":"placed","file":"modules/hall-ui/public/settings.html","line":276,"string_id":"86f235ddfe01","state":"preferences"},
+        {"key":"L0096","section":"Wandering","text":"of work — a tangent, an investigation, an unprompted suggestion — instead of staying on your claimed task. It never limits the work on the task itself. Your rank sets the starting point; newcomers stay locked low.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":276,"string_id":"99f88f2af2ee","state":"preferences"},
+        {"key":"L0097","section":"Wandering","text":"{…} file{…}","placement":"placed","file":"modules/hall-ui/public/gate.js","line":151,"string_id":"3efa67dc6e07","state":"preferences"},
+        {"key":"L0098","section":"Wandering","text":"default for your rank","placement":"placed","file":"modules/hall-ui/public/settings.js","line":420,"string_id":"4a287afb0892","state":"preferences"},
+        {"key":"L0099","section":"Wandering","text":"{…} and {…}","placement":"placed","file":"modules/hall-ui/public/profile-nudge.js","line":77,"string_id":"56b00d773232","state":"preferences"},
+        {"key":"L0100","section":"Wandering","text":"Now: {…}. Your rank allows up to {…}.","placement":"unplaced","state":"preferences"},
+        {"key":"L0101","section":"Rendering","text":"Rendering","placement":"unplaced","state":"preferences"},
+        {"key":"L0102","section":"Rendering","text":"How much your session cards — what","placement":"placed","file":"modules/hall-ui/public/settings.html","line":294,"string_id":"160adde1e398","state":"preferences"},
+        {"key":"L0103","section":"Rendering","text":", claiming, and shipping show — spend on explaining themselves. Richer cards say more and cost more tokens; leaner ones carry the same facts for less. By default this follows how Claude talks to you, so you can set it once in","placement":"placed","file":"modules/hall-ui/public/settings.html","line":295,"string_id":"1f8aceffb15e","state":"preferences"},
+        {"key":"L0104","section":"Rendering","text":"How Claude talks to you","placement":"placed","file":"modules/hall-ui/public/settings.html","line":193,"string_id":"0469a83cf1e8","state":"preferences"},
+        {"key":"L0105","section":"Rendering","text":"and leave this alone.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":299,"string_id":"2177da93be9b","state":"preferences"},
+        {"key":"L0106","section":"Rendering","text":"Session card richness","placement":"placed","file":"modules/hall-ui/public/settings-render.js","line":83,"string_id":"64a1f055129e","state":"preferences"},
+        {"key":"L0107","section":"Rendering","text":"How much the claim and ship cards show. Richer cards explain more and cost more tokens; the confirmation line is always there whichever you pick.","placement":"placed","file":"modules/hall-ui/public/settings-render.js","line":84,"string_id":"d76a5fcbde7c","state":"preferences"},
+        {"key":"L0108","section":"Rendering","text":"Match my interaction profile","placement":"unplaced","state":"preferences"},
+        {"key":"L0109","section":"Rendering","text":"default ({…})","placement":"placed","file":"modules/hall-ui/public/settings-render.js","line":64,"string_id":"4adbb8da9999","state":"preferences"},
+        {"key":"L0110","section":"Rendering","text":"{…} Change that profile and this follows it.","placement":"placed","file":"modules/hall-ui/public/settings-render.js","line":65,"string_id":"de5b58a187c6","state":"preferences"},
+        {"key":"L0111","section":"Rendering","text":"{…} and {…}","placement":"placed","file":"modules/hall-ui/public/profile-nudge.js","line":77,"string_id":"56b00d773232","state":"preferences"},
+        {"key":"L0112","section":"Rendering","text":"Saves the moment you choose; applies from your next session.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":303,"string_id":"72f24fcbe9e0","state":"preferences"},
+        {"key":"L0113","section":"Rendering","text":"Using this speciality.","placement":"placed","file":"modules/hall-ui/public/settings-specialities.js","line":350,"string_id":"e1ecd543a2ca","state":"skills-walkthrough"},
+        {"key":"L0114","section":"CLI access","text":"CLI access","placement":"placed","file":"modules/hall-ui/public/settings.html","line":133,"string_id":"a015a43bfc7f","state":"access"},
+        {"key":"L0115","section":"CLI access","text":"Mint a fresh CLI token using this browser session and paste it into your terminal — the quick way back in when a","placement":"placed","file":"modules/hall-ui/public/settings.html","line":134,"string_id":"64e91044df43","state":"access"},
+        {"key":"L0116","section":"CLI access","text":"command says your session expired.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":136,"string_id":"508ff7083048","state":"access"},
+        {"key":"L0117","section":"CLI access","text":"Re-issue CLI token","placement":"placed","file":"modules/hall-ui/public/settings.html","line":140,"string_id":"e60039795803","state":"access"},
+        {"key":"L0118","section":"CLI access","text":"paste it into your terminal — bypasses Device Flow.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":141,"string_id":"25d2c940e672","state":"access"},
+        {"key":"L0119","section":"CLI access","text":"Tokens refresh on use; re-issuing never signs you out anywhere else.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":144,"string_id":"7dfdc26f9f79","state":"access"},
+        {"key":"L0120","section":"Active sessions","text":"Active sessions","placement":"placed","file":"modules/hall-ui/public/settings.html","line":151,"string_id":"524188fe0078","state":"access"},
+        {"key":"L0121","section":"Active sessions","text":"Every place you are currently signed in — this browser, your terminal, any other machine. A session refreshes for another 24 hours each time it is used, so one you have forgotten about can stay alive indefinitely. If a token has leaked, end it here.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":152,"string_id":"c188854da766","state":"access"},
+        {"key":"L0122","section":"Active sessions","text":"Browser","placement":"unplaced","state":"access"},
+        {"key":"L0123","section":"Active sessions","text":"this session","placement":"placed","file":"modules/hall-ui/public/settings-sessions.js","line":44,"string_id":"632527db5bca","state":"access"},
+        {"key":"L0124","section":"Active sessions","text":"last used {…} · signed in {…}","placement":"placed","file":"modules/hall-ui/public/settings-sessions.js","line":46,"string_id":"9018bf6e99eb","state":"access","occurrences":3},
+        {"key":"L0125","section":"Active sessions","text":"End session","placement":"placed","file":"modules/hall-ui/public/settings-sessions.js","line":46,"string_id":"8d2b4f119ee3","state":"access","occurrences":3},
+        {"key":"L0126","section":"Active sessions","text":"Terminal","placement":"unplaced","state":"access"},
+        {"key":"L0127","section":"Active sessions","text":"Session","placement":"unplaced","state":"access"},
+        {"key":"L0128","section":"Active sessions","text":"Sign out everywhere","placement":"placed","file":"modules/hall-ui/public/settings.html","line":160,"string_id":"8ad669ab2565","state":"access"},
+        {"key":"L0129","section":"Active sessions","text":"ends every session including this one — you will be asked to sign in again.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":161,"string_id":"12a23cc46ace","state":"access"},
+        {"key":"L0130","section":"Active sessions","text":"Ending a session takes effect immediately; the token stops working on its very next request.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":163,"string_id":"8e82771e5b63","state":"access"},
+        {"key":"L0131","section":"Image-generation key","text":"Image-generation key","placement":"placed","file":"modules/hall-ui/public/settings.html","line":173,"string_id":"783853467d52","state":"access","occurrences":2},
+        {"key":"L0132","section":"Image-generation key","text":"The art pipeline draws tiles and sprites with Google AI Studio (Gemini). Needed only if you generate art — your key, your bill, paid only for what you make.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":174,"string_id":"600b90074021","state":"access"},
+        {"key":"L0133","section":"Image-generation key","text":"Your key","placement":"placed","file":"modules/hall-ui/public/settings.js","line":828,"string_id":"51fd6f1ecb2f","state":"access"},
+        {"key":"L0134","section":"Image-generation key","text":"Paste your Google AI Studio key","placement":"unplaced","attr":"placeholder","state":"access"},
+        {"key":"L0135","section":"Image-generation key","text":"Save key","placement":"placed","file":"modules/hall-ui/public/settings.js","line":832,"string_id":"0c79b504aebe","state":"access"},
+        {"key":"L0136","section":"Image-generation key","text":"Get a free key ↗","placement":"placed","file":"modules/hall-ui/public/settings.js","line":800,"string_id":"2ae2114b61db","state":"access"},
+        {"key":"L0137","section":"Image-generation key","text":"· Stored encrypted; never shown again after saving.","placement":"placed","file":"modules/hall-ui/public/settings.js","line":834,"string_id":"b3757ba3bb46","state":"access"},
+        {"key":"L0138","section":"Image-generation key","text":"Stored encrypted; never shown again after saving — only its last four digits.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":182,"string_id":"6c6544f5c011","state":"access"},
+        {"key":"L0139","section":"Connections","text":"Connections","placement":"unplaced"},
+        {"key":"L0140","section":"Connections","text":"Link your Discord account and you're added to the {{worldName}} server with your rank role already set — no invite to share or leak.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":64,"string_id":"64e85f1691f9"},
+        {"key":"L0141","section":"Connections","text":"Discord connected ✓","placement":"placed","file":"modules/hall-ui/public/settings.js","line":676,"string_id":"0f685daf1bd5"},
+        {"key":"L0142","section":"Connections","text":"You're in the {…} server with your rank role.","placement":"placed","file":"modules/hall-ui/public/settings.js","line":677,"string_id":"8e1915b19274"},
+        {"key":"L0143","section":"Connections","text":"Unlink","placement":"unplaced"},
+        {"key":"L0144","section":"Connections","text":"Linking opens Discord's consent screen; unlinking applies at once.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":69,"string_id":"9a31cf5fe05b"},
+        {"key":"L0145","section":"Display name","text":"Display name","placement":"placed","file":"modules/hall-ui/public/settings.html","line":77,"string_id":"3e561393f4e9","occurrences":2},
+        {"key":"L0146","section":"Display name","text":"The name shown beside your work — in the roster, the leaderboard, and the work feed. Your sign-in and the credit for shipped work stay tied to your account, not this label.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":78,"string_id":"82479c539fca"},
+        {"key":"L0147","section":"Display name","text":"Your display name","placement":"placed","file":"modules/hall-ui/public/settings.html","line":87,"string_id":"909b0b7c6ffa","attr":"placeholder"},
+        {"key":"L0148","section":"Display name","text":"Save","placement":"unplaced"},
+        {"key":"L0149","section":"Display name","text":"Saves when you press Save; shows everywhere at once.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":91,"string_id":"e8e4e49fe8f4"},
+        {"key":"L0150","section":"Preferred roles","text":"Preferred roles","placement":"placed","file":"modules/hall-ui/public/settings.html","line":115,"string_id":"e883f2789cae"},
+        {"key":"L0151","section":"Preferred roles","text":"The kinds of work you prefer. Task suggestions lean toward your choices — pick one, several, or none.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":116,"string_id":"9f45c63c9697"},
+        {"key":"L0152","section":"Preferred roles","text":"Artist","placement":"unplaced"},
+        {"key":"L0153","section":"Preferred roles","text":"Ideator","placement":"unplaced"},
+        {"key":"L0154","section":"Preferred roles","text":"UI","placement":"unplaced"},
+        {"key":"L0155","section":"Preferred roles","text":"Save","placement":"unplaced"},
+        {"key":"L0156","section":"Preferred roles","text":"Saves when you press Save; your next","placement":"placed","file":"modules/hall-ui/public/settings.html","line":125,"string_id":"42cbc20a6ec8"},
+        {"key":"L0157","section":"Preferred roles","text":"reflects it.","placement":"placed","file":"modules/hall-ui/public/settings.html","line":125,"string_id":"26da1df6fd4a"}
       ]
     },
     {

package/modules/hall-ui/public/settings-specialities.js

@@ -24,7 +24,9 @@
   const { escapeHtml, $ } = window.OTB;
   const toast = (msg) => window.OTB.toast(msg);
 
-  const state = { rows: [], suggestions: [], openId: null, busy: false };
+  // `walk` is the skills walkthrough in progress, or null (task 1004073):
+  // { id, data, step, decisions, saving }. See walkHtml below.
+  const state = { rows: [], suggestions: [], openId: null, busy: false, walk: null };
 
   const el = (id) => document.getElementById(id);
   const statusLine = (msg) => { const s = el('specialities-status'); if (s) s.textContent = msg || ''; };
@@ -73,10 +75,148 @@
       </details>`;
   }
 
+  // ── THE SKILLS WALKTHROUGH (task 1004073; ADR 0310 §3) ────────────────────
+  //
+  // The owner's ruling: an adopted speciality's skills start OFF, "and you
+  // should walk through what comes with each, people need to learn the system".
+  // So this is deliberately NOT a list of checkboxes. It shows ONE skill at a
+  // time — what it does, when to reach for it, what it costs — and moves on only
+  // once the person has decided about that one. There is no "turn them all on"
+  // and no skip: the bar is that someone who finishes can say what each skill
+  // does, and a control that decides without reading defeats it.
+  //
+  // Nothing is written until the recap's "Save my choices", and that sends the
+  // WHOLE set (PUT replaces it), so walking away half-way leaves every skill off —
+  // the default the ruling asked for. Turning a skill on grants nothing: a
+  // rank-gated skill stays rank-gated, and the step says so before you choose.
+
+  const walkSteps = (w) => (w.data.skills || []).filter((k) => k.installed);
+
+  const RANK_COPY = {
+    metic: 'Only builders of Metic rank or above can run it. Turning it on here does not change that.',
+    archon: 'Only the project owner (Archon) can run it. Turning it on here does not change that.',
+  };
+
+  async function openWalk(id) {
+    try {
+      const data = await call('GET', `/specialities/${id}/skills`);
+      if (!data) return;
+      if (!walkSteps({ data }).length) { toast('This speciality offers no skills to choose.'); return; }
+      state.walk = { id: String(id), data, step: 0, decisions: {}, saving: false };
+      state.openId = null;
+      render();
+      focusWalk();
+    } catch (err) { statusLine(`Could not load its skills — ${err.message}`); }
+  }
+
+  // Each step replaces the panel's contents, so focus goes to the new heading —
+  // otherwise a keyboard or screen-reader user is left on a button that no
+  // longer exists. Focus only; nothing animates.
+  function focusWalk() {
+    const h = document.querySelector('.skill-walk [data-walk-focus]');
+    if (h) h.focus();
+  }
+
+  function stepHtml(w, k, i, total) {
+    const was = w.data.enabled.includes(k.name);
+    const decided = w.decisions[k.name];
+    const commands = (k.commands || []).length
+      ? ` You can also start it yourself by typing <code>${escapeHtml(k.commands[0])}</code>.` : '';
+    const guessed = k.derived && (k.derived.does || k.derived.cost)
+      ? '<p class="prow__hint skill-walk__note">These words come from the skill’s own description, which was written for Claude to recognise rather than for you to read — so a term may go unexplained.</p>'
+      : '';
+    return `
+      <p class="skill-walk__progress">Skill ${i + 1} of ${total} in ${escapeHtml(w.data.speciality.name)}</p>
+      <h4 class="skill-walk__name" tabindex="-1" data-walk-focus>${escapeHtml(k.name)}</h4>
+      <dl class="skill-walk__facts">
+        <dt>What it does</dt><dd>${escapeHtml(k.does || 'Its author gave no description.')}</dd>
+        <dt>When to reach for it</dt><dd>${escapeHtml(k.reachFor || 'Its author did not say.')}${commands}</dd>
+        <dt>What it costs</dt><dd>${escapeHtml(k.cost)}</dd>
+        ${(k.needs || []).length ? `<dt>What it needs on your machine</dt><dd>${k.needs.map((n) => `<code>${escapeHtml(n)}</code>`).join(', ')}</dd>` : ''}
+        ${k.rank && RANK_COPY[k.rank] ? `<dt>Who can run it</dt><dd>${RANK_COPY[k.rank]}</dd>` : ''}
+      </dl>
+      ${guessed}
+      ${was ? '<p class="prow__hint">You have this one on at the moment.</p>' : ''}
+      <div class="speciality-actions skill-walk__actions">
+        ${i > 0 ? '<button type="button" class="pbtn pbtn--quiet" data-walk="back">Back</button>' : ''}
+        <button type="button" class="pbtn" data-walk="off" aria-pressed="${decided === false}">Leave it off</button>
+        <button type="button" class="pbtn" data-walk="on" aria-pressed="${decided === true}">Turn it on</button>
+      </div>`;
+  }
+
+  function recapHtml(w, steps) {
+    const on = steps.filter((k) => w.decisions[k.name]).length;
+    const gone = (w.data.skills || []).filter((k) => !k.installed);
+    return `
+      <h4 class="skill-walk__name" tabindex="-1" data-walk-focus>Your choices for ${escapeHtml(w.data.speciality.name)}</h4>
+      <p class="prow__hint">${on} of ${steps.length} turned on. Each one, in a line:</p>
+      <ul class="skill-walk__recap">
+        ${steps.map((k) => `
+          <li>
+            <strong>${escapeHtml(k.name)}</strong>
+            <span class="speciality-badge${w.decisions[k.name] ? ' speciality-badge--on' : ''}">${w.decisions[k.name] ? 'on' : 'off'}</span>
+            <span class="prow__hint">${escapeHtml(firstSentence(k.does))}</span>
+          </li>`).join('')}
+      </ul>
+      ${gone.length ? `<p class="prow__hint">Also offered, but no longer on this project, so it cannot be turned on: ${gone.map((k) => `<code>${escapeHtml(k.name)}</code>`).join(', ')}.</p>` : ''}
+      <div class="speciality-actions skill-walk__actions">
+        <button type="button" class="pbtn pbtn--quiet" data-walk="restart">Go through them again</button>
+        <button type="button" class="pbtn pbtn--save" data-walk="save" ${w.saving ? 'disabled' : ''}>Save my choices</button>
+      </div>`;
+  }
+
+  function firstSentence(text) {
+    const t = String(text || '');
+    const m = /^(.+?[.!?])(\s|$)/.exec(t);
+    return m ? m[1] : t;
+  }
+
+  function walkHtml() {
+    const w = state.walk;
+    const steps = walkSteps(w);
+    const body = w.step < steps.length ? stepHtml(w, steps[w.step], w.step, steps.length) : recapHtml(w, steps);
+    return `<section class="skill-walk" aria-label="Choose the skills for ${escapeHtml(w.data.speciality.name)}">
+      ${body}
+      <button type="button" class="skill-walk__later" data-walk="close">Finish later — everything stays off until you save</button>
+    </section>`;
+  }
+
+  async function walkAct(action) {
+    const w = state.walk;
+    if (!w) return;
+    const steps = walkSteps(w);
+    if (action === 'close') { state.walk = null; render(); return; }
+    if (action === 'back') w.step = Math.max(0, w.step - 1);
+    if (action === 'restart') w.step = 0;
+    if ((action === 'on' || action === 'off') && w.step < steps.length) {
+      w.decisions[steps[w.step].name] = action === 'on';
+      w.step += 1;
+    }
+    if (action === 'save') {
+      w.saving = true;
+      render();
+      try {
+        const enabled = steps.filter((k) => w.decisions[k.name]).map((k) => k.name);
+        await call('PUT', `/specialities/${w.id}/skills`, { enabled_skills: enabled });
+        state.walk = null;
+        toast(`Saved — ${enabled.length} of ${steps.length} skill${steps.length === 1 ? '' : 's'} on.`);
+        await load();
+        return;
+      } catch (err) {
+        w.saving = false;
+        statusLine(`Could not save your choices — ${err.message}`);
+      }
+    }
+    render();
+    focusWalk();
+  }
+
   function cardHtml(s) {
     const trained = Number(s.documentCount || 0);
     const learned = Number(s.learningCount || 0);
     const open = String(state.openId) === String(s.id);
+    const offered = Array.isArray(s.skills) ? s.skills.length : 0;
+    const walking = state.walk && state.walk.id === String(s.id);
     return `
       <li class="prow speciality-card" data-id="${escapeHtml(String(s.id))}">
         <div class="prow__main">
@@ -91,15 +231,18 @@
             Trained on <strong>${trained}</strong> document${trained === 1 ? '' : 's'} you added
             · learned <strong>${learned}</strong> thing${learned === 1 ? '' : 's'} from your sessions
             · shared with: ${escapeHtml(VISIBILITY_COPY[s.visibility] || s.visibility || 'only you')}
+            ${offered ? `· offers <strong>${offered}</strong> skill${offered === 1 ? '' : 's'}${s.active ? `, <strong>${(s.enabled_skills || []).length}</strong> on for you` : ''}` : ''}
           </p>
         </div>
         <div class="prow__actions">
+          ${s.active && offered && !walking ? `<button type="button" class="btn btn--quiet" data-act="walk" data-id="${escapeHtml(String(s.id))}">Choose its skills</button>` : ''}
           ${s.mine ? `<button type="button" class="btn btn--quiet" data-act="train" data-id="${escapeHtml(String(s.id))}">${open ? 'Close' : 'Train'}</button>` : ''}
           ${s.active
             ? `<button type="button" class="btn btn--quiet" data-act="abandon" data-id="${escapeHtml(String(s.id))}">Stop using</button>`
             : `<button type="button" class="btn" data-act="adopt" data-id="${escapeHtml(String(s.id))}" ${s.adoptable ? '' : 'disabled'}>Use this</button>`}
         </div>
         ${open ? trainHtml(s) : ''}
+        ${walking ? walkHtml() : ''}
       </li>`;
   }
 
@@ -183,10 +326,18 @@
       ]);
       if (!cat) return;
       state.suggestions = (offered && offered.suggestions) || [];
-      const activeIds = new Set(((mine && mine.adoptions) || []).filter((a) => a.active).map((a) => String(a.id)));
-      state.rows = ((cat && cat.specialities) || []).map((s) => ({ ...s, active: activeIds.has(String(s.id)) }));
+      const active = new Map(((mine && mine.adoptions) || []).filter((a) => a.active).map((a) => [String(a.id), a]));
+      state.rows = ((cat && cat.specialities) || []).map((s) => {
+        const a = active.get(String(s.id));
+        return { ...s, active: !!a, enabled_skills: (a && a.enabled_skills) || [] };
+      });
       render();
       statusLine('');
+      // The section ships `hidden`, like every settings panel, and is revealed
+      // once its reads answer. Nothing revealed this one until task 1004073, so
+      // the panel — and adoption with it — was unreachable from the hall.
+      const section = el('specialities-scroll');
+      if (section) section.hidden = false;
     } catch (err) {
       statusLine(`Could not load specialities — ${err.message}`);
     }
@@ -197,8 +348,18 @@
     state.busy = true;
     try {
       if (action === 'adopt') { await call('POST', `/specialities/${id}/adopt`); toast('Using this speciality.'); }
-      if (action === 'abandon') { await call('POST', `/specialities/${id}/abandon`); toast('Stopped using it.'); }
+      if (action === 'abandon') {
+        await call('POST', `/specialities/${id}/abandon`);
+        toast('Stopped using it.');
+        if (state.walk && state.walk.id === String(id)) state.walk = null;
+      }
       await load();
+      // Adopting is the moment the ruling is about: a speciality that offers
+      // skills opens straight into the walkthrough, with every one still off.
+      if (action === 'adopt') {
+        const row = state.rows.find((s) => String(s.id) === String(id));
+        if (row && Array.isArray(row.skills) && row.skills.length) await openWalk(id);
+      }
     } catch (err) {
       statusLine(err.message);
     } finally {
@@ -221,10 +382,13 @@
     const host = el('specialities-rows');
     if (host) {
       host.addEventListener('click', (e) => {
+        const walkBtn = e.target.closest('button[data-walk]');
+        if (walkBtn) { walkAct(walkBtn.dataset.walk); return; }
         const btn = e.target.closest('button[data-act]');
         if (!btn) return;
         const { act: action, id } = btn.dataset;
-        if (action === 'train') { state.openId = String(state.openId) === String(id) ? null : id; render(); return; }
+        if (action === 'walk') { openWalk(id); return; }
+        if (action === 'train') { state.openId = String(state.openId) === String(id) ? null : id; state.walk = null; render(); return; }
         act(action, id);
       });