@bongos/core 1.20.9 → 1.20.11

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

@@ -26,7 +26,9 @@
 
   // `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 };
+  // `offerId` / `offerChoices`: the owner's "what it offers" editor that is open,
+  // and its rendered choices once the instance's skills have loaded (task 1004404).
+  const state = { rows: [], suggestions: [], openId: null, busy: false, walk: null, offerId: null, offerChoices: null };
 
   const el = (id) => document.getElementById(id);
   const statusLine = (msg) => { const s = el('specialities-status'); if (s) s.textContent = msg || ''; };
@@ -211,12 +213,112 @@
     focusWalk();
   }
 
+  // ── WHAT A SPECIALITY OFFERS (task 1004404; ADR 0310 §1) ──────────────────
+  //
+  // The OWNER's half: which of this instance's skills the speciality puts on
+  // its menu. Until this, only the API could set it, so nothing made in the hall
+  // offered anything and the walkthrough above never appeared. Each choice shows
+  // the skill's plain description — the same words the walkthrough will show the
+  // people who adopt it — so the owner is choosing what to teach, not ticking
+  // names. Offering turns nothing on for anyone: every adopter still starts with
+  // all of them off and decides one at a time.
+  //
+  // The choices come from GET /specialities/installed-skills, so only skills
+  // this instance has are offered; the server's unknown_skill check on POST/PATCH
+  // stays the rule for anything a stale page sends.
+
+  let installedList = null; // fetched once per page, on first need
+  async function installedSkillList() {
+    if (!installedList) {
+      const data = await call('GET', '/specialities/installed-skills');
+      installedList = (data && data.skills) || [];
+    }
+    return installedList;
+  }
+
+  function offerChoicesHtml(all, chosen) {
+    const picked = new Set(chosen || []);
+    const gone = (chosen || []).filter((n) => !all.some((k) => k.name === n));
+    return `
+      <p class="prow__hint">
+        Offering a skill turns nothing on. Everyone who uses this speciality is shown
+        each one and chooses for themselves — all start off.
+      </p>
+      <label class="speciality-field">
+        <span>Find a skill</span>
+        <input type="search" class="speciality-offer__filter" placeholder="Type to narrow the list" />
+      </label>
+      <ul class="speciality-offer__list">
+        ${all.map((k) => `
+          <li data-find="${escapeHtml(`${k.name} ${k.does || ''}`.toLowerCase())}">
+            <label class="speciality-field speciality-field--check">
+              <input type="checkbox" name="skill" value="${escapeHtml(k.name)}" ${picked.has(k.name) ? 'checked' : ''} />
+              <span>
+                <strong>${escapeHtml(k.name)}</strong> — ${escapeHtml(k.does || 'Its author gave no description.')}
+                <small>${escapeHtml(k.cost || '')}</small>
+              </span>
+            </label>
+          </li>`).join('')}
+      </ul>
+      ${gone.length ? `<p class="prow__hint">No longer on this project, so saving drops it from the offer: ${gone.map((n) => `<code>${escapeHtml(n)}</code>`).join(', ')}.</p>` : ''}`;
+  }
+
+  const chosenSkills = (form) => [...form.querySelectorAll('input[name="skill"]:checked')].map((i) => i.value);
+
+  function narrowOffer(input) {
+    const q = input.value.trim().toLowerCase();
+    const list = input.closest('form') && input.closest('form').querySelector('.speciality-offer__list');
+    if (!list) return;
+    for (const li of list.children) li.hidden = q !== '' && !String(li.dataset.find || '').includes(q);
+  }
+
+  function offerFormHtml(s) {
+    return `
+      <form class="speciality-offer" data-id="${escapeHtml(String(s.id))}">
+        <h4 class="speciality-create__h">What ${escapeHtml(s.name)} offers</h4>
+        <div class="speciality-offer__choices">${state.offerChoices || '<p class="prow__hint">Loading this project’s skills…</p>'}</div>
+        <div class="speciality-actions">
+          <button type="submit" class="btn" ${state.offerChoices ? '' : 'disabled'}>Save what it offers</button>
+        </div>
+      </form>`;
+  }
+
+  async function openOffer(id) {
+    if (String(state.offerId) === String(id)) { state.offerId = null; render(); return; }
+    state.offerId = String(id);
+    state.offerChoices = null;
+    state.openId = null;
+    state.walk = null;
+    render();
+    try {
+      const all = await installedSkillList();
+      const row = state.rows.find((r) => String(r.id) === String(id));
+      if (state.offerId !== String(id) || !row) return;
+      state.offerChoices = offerChoicesHtml(all, row.skills || []);
+      render();
+    } catch (err) { statusLine(`Could not load this project’s skills — ${err.message}`); }
+  }
+
+  // The create form's picker fills the first time it is opened, so a builder
+  // who never offers a skill never pays for the list.
+  async function fillCreateOffer(host) {
+    if (host.dataset.filled) return;
+    host.dataset.filled = '1';
+    try {
+      host.innerHTML = offerChoicesHtml(await installedSkillList(), []);
+    } catch (err) {
+      delete host.dataset.filled;
+      host.innerHTML = `<p class="prow__hint">Could not load this project’s skills — ${escapeHtml(err.message)}</p>`;
+    }
+  }
+
   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);
+    const offering = s.mine && String(state.offerId) === String(s.id);
     return `
       <li class="prow speciality-card" data-id="${escapeHtml(String(s.id))}">
         <div class="prow__main">
@@ -237,11 +339,13 @@
         <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.mine ? `<button type="button" class="btn btn--quiet" data-act="offer" data-id="${escapeHtml(String(s.id))}" aria-expanded="${offering}">${offering ? 'Close' : 'Offered skills'}</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) : ''}
+        ${offering ? offerFormHtml(s) : ''}
         ${walking ? walkHtml() : ''}
       </li>`;
   }
@@ -388,11 +492,28 @@
         if (!btn) return;
         const { act: action, id } = btn.dataset;
         if (action === 'walk') { openWalk(id); return; }
-        if (action === 'train') { state.openId = String(state.openId) === String(id) ? null : id; state.walk = null; render(); return; }
+        if (action === 'offer') { openOffer(id); return; }
+        if (action === 'train') { state.openId = String(state.openId) === String(id) ? null : id; state.walk = null; state.offerId = null; render(); return; }
         act(action, id);
       });
 
+      host.addEventListener('input', (e) => {
+        if (e.target.matches('.speciality-offer__filter')) narrowOffer(e.target);
+      });
+
       host.addEventListener('submit', async (e) => {
+        const offer = e.target.closest('form.speciality-offer');
+        if (offer) {
+          e.preventDefault();
+          const skills = chosenSkills(offer);
+          try {
+            await call('PATCH', `/specialities/${offer.dataset.id}`, { skills });
+            state.offerId = null;
+            toast(skills.length ? `Saved — it offers ${skills.length} skill${skills.length === 1 ? '' : 's'}.` : 'Saved — it offers no skills.');
+            await load();
+          } catch (err) { statusLine(`Could not save what it offers — ${err.message}`); }
+          return;
+        }
         const form = e.target.closest('form.speciality-train');
         if (!form) return;
         e.preventDefault();
@@ -426,8 +547,10 @@
             contract_md: create.elements.contract_md.value.trim(),
             visibility: create.elements.visibility.value,
             sellable: create.elements.sellable.checked,
+            skills: chosenSkills(create),
           });
           create.reset();
+          for (const li of create.querySelectorAll('.speciality-offer__list > li')) li.hidden = false;
           toast('Speciality created.');
           await load();
         } catch (err) { statusLine(err.message); }
@@ -445,7 +568,21 @@
       };
       vis.addEventListener('change', sync);
       sync();
+
+      // The skills picker (task 1004404): filled on first open, narrowed as you type.
+      const offerBox = el('speciality-create-offer');
+      const offerHost = el('speciality-create-skills');
+      if (offerBox && offerHost) offerBox.addEventListener('toggle', () => { if (offerBox.open) fillCreateOffer(offerHost); });
+      create.addEventListener('input', (e) => {
+        if (e.target.matches('.speciality-offer__filter')) narrowOffer(e.target);
+      });
     }
+
+    // Enter in a "Find a skill" box narrows the list; it must not submit the
+    // form around it half-chosen.
+    document.addEventListener('keydown', (e) => {
+      if (e.key === 'Enter' && e.target && e.target.matches && e.target.matches('.speciality-offer__filter')) e.preventDefault();
+    });
   }
 
   function boot() {

package/modules/hall-ui/public/settings.css

@@ -199,6 +199,32 @@ select.voices__select { min-width: 140px; }
 .speciality-field--check { flex-direction: row; align-items: flex-start; gap: 0.5rem; }
 .speciality-field--check input { margin-top: 0.2rem; }
 .speciality-actions { display: flex; gap: 0.5rem; }
+/* What a speciality OFFERS (task 1004404): the owner's pick-list of this
+   instance's skills, each with its plain line. Sixty-odd rows, so the list
+   scrolls inside its own box rather than pushing the form's buttons off-screen;
+   the reading lines keep the measure. */
+.speciality-field input[type='search'] { width: 100%; box-sizing: border-box; }
+.speciality-offer,
+.speciality-offer-box { flex-basis: 100%; display: flex; flex-direction: column; gap: 0.6rem; }
+.speciality-offer { margin-top: 0.75rem; padding-top: 0.75rem; border-top: 1px solid var(--rule); }
+.speciality-offer > *, .speciality-offer-box > * { max-width: var(--measure); }
+.speciality-offer-box > summary { cursor: pointer; font-size: 0.85rem; min-height: 24px; padding-block: 2px; box-sizing: border-box; }
+.speciality-offer-box > summary small { opacity: 0.7; }
+.speciality-offer__choices, #speciality-create-skills { display: flex; flex-direction: column; gap: 0.6rem; }
+.speciality-offer__list {
+  list-style: none;
+  margin: 0;
+  padding: 0 0.25rem 0 0;
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+  max-height: 24rem;
+  overflow-y: auto;
+  overflow-x: hidden;
+}
+.speciality-offer__list li[hidden] { display: none; }
+.speciality-offer__list strong { font-family: var(--font-mono); font-weight: 600; }
+.speciality-offer__list .speciality-field--check > span { font-size: 0.85rem; line-height: 1.45; }
 /* The adopted contract, shown in full before "Use this" — another builder's prose
    reaching your sessions is the one thing here that must never be folded away. */
 .speciality-contract { flex-basis: 100%; margin-top: 0.5rem; font-size: 0.85rem; }

package/modules/hall-ui/public/settings.html

@@ -259,6 +259,10 @@
                     <small>Records your decision only — there is no marketplace yet, and nothing is listed anywhere.</small>
                   </span>
                 </label>
+                <details id="speciality-create-offer" class="speciality-offer-box">
+                  <summary>Skills it offers <small>(optional)</small></summary>
+                  <div id="speciality-create-skills"><p class="prow__hint">Loading this project’s skills…</p></div>
+                </details>
                 <div class="speciality-actions">
                   <button type="submit" class="btn">Create speciality</button>
                 </div>

package/modules/hall-ui/public/settings.states.json

@@ -11,6 +11,7 @@
     "access": { "auth": true, "url": "/settings#access", "actions": [["wait", 900]], "expect": { "visible": ["#cli-reissue-btn", "#sessions-list", "#artkey-card"] } },
     "preferences": { "auth": true, "url": "/settings#preferences", "actions": [["wait", 900]], "expect": { "visible": ["#wander-rows", "#render-rows", "#specialities-rows"] } },
     "skills-walkthrough": { "auth": true, "url": "/settings#preferences", "actions": [["wait", 900], ["click", "#specialities-rows button[data-act=\"adopt\"]"], ["wait", 700]], "expect": { "visible": [".skill-walk", ".skill-walk__facts", "button[data-walk=\"on\"]", "button[data-walk=\"off\"]"] } },
+    "offered-skills": { "auth": true, "url": "/settings#preferences", "actions": [["wait", 900], ["click", "#specialities-rows button[data-act=\"offer\"]"], ["wait", 700]], "expect": { "visible": ["form.speciality-offer", ".speciality-offer__list", ".speciality-offer__filter"] } },
     "sound": { "auth": true, "url": "/settings#sound", "actions": [["wait", 900]], "expect": { "visible": ["#voices-table", "#sound-rows", "#event-sound-rows"] } },
     "update": { "auth": true, "url": "/settings#software-update", "actions": [["wait", 1200]], "expect": { "visible": ["#software-update-h", "#su-body", "#su-update", ".su-versions"] } }
   },

package/modules/hall-ui/records/panel-family.md

@@ -28,3 +28,5 @@ Also fixed here, as the board task handed forward: the two sub-24px links on Hom
 - **Kit:** `settings.states.json` `update`, ALL CLEAN at 1440/390/320 × dark/light against the harness with the fixture `software-update.json` (a live reading for 1.19.1033). Tests: `tests/software_update.mjs`.
 
 **Settings: adopting a speciality walks through its skills (task 1004073, ADR 0310 §3)** — the owner ruled an adopted speciality's skills start OFF "and you should walk through what comes with each". So adopting one that offers skills opens `.skill-walk` inside its card: one skill per step (what it does, when to reach for it, what it costs, what it needs, who can run it), "Leave it off" / "Turn it on" at EQUAL weight (plain `.pbtn`, no accent — the default is off, so the page must not lean toward on), Back, then a recap restating each skill in a line, then ONE `PUT` of the whole set. "Finish later" saves nothing. Focus moves to each new step heading. Two things found on the way: the specialities panel shipped `hidden` and nothing ever revealed it, so adoption was unreachable from the hall; and its contract `<summary>` measured 21px once visible (now 24). **Kit:** `settings.states.json` `skills-walkthrough` + `preferences`, ALL CLEAN at 1440/390/320 × dark/light against the harness, with fixtures `specialities*.json` built from the real skills on disk and canned answers for adopt and save. Tests: `tests/speciality_walkthrough_ui.mjs` (runs the real page script).
+
+**Settings: a speciality's owner chooses what it offers (task 1004404, ADR 0310 §1)** — until this only the API could set an offer, so the walkthrough above never appeared for a speciality made in the hall. The create form gains a `<details>` "Skills it offers" picker (filled on first open, so a builder who never offers one never pays for the list), and an owned card gains "Offered skills", an inline `form.speciality-offer` like Train. Both list `GET /specialities/installed-skills` — only what this instance has — each row a checkbox with the skill's plain line and cost, the words adopters will see, under a line saying offering turns nothing on. A "Find a skill" box narrows the sixty-odd rows (Enter never submits), the list scrolls in its own box, an offered skill removed since is named and dropped on save rather than silently kept, and saving is ONE `PATCH { skills }`. **The checkboxes take the shared 24px rule in `panel.css`** (the `.chip-ctl input` / `.craft-pref` block, one selector added) rather than a fourth copy of the `::before` box; without it 128 targets measured 13px. **Kit:** `settings.states.json` `offered-skills` + `preferences`, ALL CLEAN at 1440/390/320 × dark/light, with fixtures `specialities__installed-skills.json` (the real 64 skills, explained) and an owned speciality in `specialities.json`, plus canned POST/PATCH answers. Tests: `tests/speciality_offer_ui.mjs` (runs the real page script).

package/modules/specialities/routes/specialities.js

@@ -285,6 +285,22 @@ module.exports = function buildSpecialitiesRouter() {
     res.json({ suggestions });
   }));
 
+  // GET /specialities/installed-skills — every skill THIS instance has, each
+  // explained the way the adoption walkthrough explains it, so a speciality's
+  // owner can choose what it offers from the hall (task 1004404). The CHOICES
+  // only: the POST/PATCH `skills` check (unknown_skill) is still the rule, so a
+  // stale page that sends a name removed since is refused, not trusted. Nothing
+  // here is per-builder and the list is public knowledge of the install — every
+  // name is already materialised into each checkout's .claude/skills/.
+  // Mounted before '/specialities/:id' would capture it as an id. Read-only;
+  // rank: any builder.
+  router.get('/specialities/installed-skills', api.requireBuilder, asyncHandler('GET /specialities/installed-skills', async (_req, res) => {
+    const skills = [...installedSkills()]
+      .map(([name, entry]) => skillsLib.explainSkill({ name, ...entry }))
+      .sort((a, b) => a.name.localeCompare(b.name));
+    res.json({ skills });
+  }));
+
   router.get('/specialities/:id', api.requireBuilder, asyncHandler('GET /specialities/:id', async (req, res) => {
     const id = parseId(req, res, { code: 'bad_id' });
     if (id === null) return;

package/modules/ui-design/skills/brandkit/SKILL.md

@@ -5,6 +5,12 @@ description: >-
   first, holds the logo standard and the five concept methods, and lands the system as the instance's own
   materials — the mark as SVG, the colours as the pack, the type as its faces. Triggers on "brand kit",
   "identity system", "logo system". Never generates a logo, wordmark or UI mockup.
+plain: >-
+  Builds the project's visual identity, its logo, colours and typefaces, as the project's own files.
+reach-for: >-
+  When the project needs a brand identity, or its identity needs pulling together.
+cost: >-
+  Uses your session. It adds brand files to the project and never generates a logo image.
 ---
 
 <!-- BEGIN PLATFORM PREAMBLE · ui-design module · one block, byte-identical in every skill the module ships (vendored or rebuilt in-house) so an upstream refresh is a three-way merge; the source is modules/ui-design/skills/PREAMBLE.md and tests/ui_design_skills.mjs fails on drift -->

package/modules/ui-design/skills/design-taste-frontend/SKILL.md

@@ -5,6 +5,12 @@ description: >-
   Says the design read in one line, sets three dials (variance, motion, density), locks one world for the
   whole page, and ends on a pre-flight the kit measures. Triggers on "design a landing page", "make this not
   look templated", "taste pass", "anti-slop". Not for dashboards or native mobile.
+plain: >-
+  The default way to give a landing page or marketing page a strong, considered look that does not feel like a template.
+reach-for: >-
+  When a landing or marketing page looks generic.
+cost: >-
+  Uses your session. It changes the page, and you check it on a preview.
 ---
 
 <!-- BEGIN PLATFORM PREAMBLE · ui-design module · one block, byte-identical in every skill the module ships (vendored or rebuilt in-house) so an upstream refresh is a three-way merge; the source is modules/ui-design/skills/PREAMBLE.md and tests/ui_design_skills.mjs fails on drift -->

package/modules/ui-design/skills/design-taste-frontend-v1/SKILL.md

@@ -5,6 +5,12 @@ description: >-
   gets exactly this behaviour while the default (design-taste-frontend) evolves separately. A fixed triple of
   dials, the layout bans, full interaction cycles, and a named vocabulary of premium patterns. Triggers on
   "design-taste-frontend-v1", "the fixed dials", "the pattern vocabulary".
+plain: >-
+  The earlier version of the landing-page style guide, kept so work that asked for it gets exactly the same results.
+reach-for: >-
+  Only when a task asks for this older version by name.
+cost: >-
+  Uses your session. It changes the page, and you check it on a preview.
 ---
 
 <!-- BEGIN PLATFORM PREAMBLE · ui-design module · one block, byte-identical in every skill the module ships (vendored or rebuilt in-house) so an upstream refresh is a three-way merge; the source is modules/ui-design/skills/PREAMBLE.md and tests/ui_design_skills.mjs fails on drift -->

package/modules/ui-design/skills/gpt-taste/SKILL.md

@@ -5,6 +5,12 @@ description: >-
   every other one. A written plan block before any markup, derived deterministically from the route; the
   four-stage attention-interest-desire-action structure; an ultra-wide hero; a dense tile grid with zero empty
   cells. Triggers on "it looks generic", "award-tier", "anti-default".
+plain: >-
+  A stricter style pass for a long, persuasive page that keeps coming out looking like every other one.
+reach-for: >-
+  When a scrolling sales or landing page still looks generic after a first try.
+cost: >-
+  Uses your session. It changes the page, and you check it on a preview.
 ---
 
 <!-- BEGIN PLATFORM PREAMBLE · ui-design module · one block, byte-identical in every skill the module ships (vendored or rebuilt in-house) so an upstream refresh is a three-way merge; the source is modules/ui-design/skills/PREAMBLE.md and tests/ui_design_skills.mjs fails on drift -->

package/modules/ui-design/skills/high-end-visual-design/SKILL.md

@@ -5,6 +5,12 @@ description: >-
   one layout archetype per project, the container anatomy, the pill button, the spatial rhythm, the motion
   choreography inside the Kill Switch, the mobile collapse, then a pre-output checklist. Triggers on "make it
   feel premium", "agency-grade", "this looks cheap", "the polish pass".
+plain: >-
+  Makes a page look expensive and professionally made, while staying in the project's own style.
+reach-for: >-
+  When a page looks cheap or unfinished.
+cost: >-
+  Uses your session. It changes the page, and you check it on a preview.
 ---
 
 <!-- BEGIN PLATFORM PREAMBLE · ui-design module · one block, byte-identical in every skill the module ships (vendored or rebuilt in-house) so an upstream refresh is a three-way merge; the source is modules/ui-design/skills/PREAMBLE.md and tests/ui_design_skills.mjs fails on drift -->

package/modules/ui-design/skills/image-to-code/SKILL.md

@@ -5,6 +5,12 @@ description: >-
   design source of truth is the owner's reference images and the instance's world, read per image and
   extracted into a full spec before a line is written. Triggers on "build this from the reference", "implement
   the mock faithfully". Never generates a section, comp or screen.
+plain: >-
+  Builds a page faithfully from reference pictures you provide, studying each one first.
+reach-for: >-
+  When you have images of how a page should look and want it built to match.
+cost: >-
+  Uses your session. It builds the page and never generates images itself.
 ---
 
 <!-- BEGIN PLATFORM PREAMBLE · ui-design module · one block, byte-identical in every skill the module ships (vendored or rebuilt in-house) so an upstream refresh is a three-way merge; the source is modules/ui-design/skills/PREAMBLE.md and tests/ui_design_skills.mjs fails on drift -->

package/modules/ui-design/skills/imagegen-frontend-mobile/SKILL.md

@@ -5,6 +5,12 @@ description: >-
   portrait plates and hero objects for the 390 and 320 compositions the kit renders, sized for the fold and
   clear of what a phone reserves, with a sidecar beside every file. Triggers on "a plate for the mobile hero",
   "the masthead at 390". Never a screen, a phone mockup or code.
+plain: >-
+  Makes the large picture at the top of a page, sized for phones, with no text in it.
+reach-for: >-
+  When a page's phone layout needs its main picture.
+cost: >-
+  Paid: each image is made on the project's image key. It adds the picture files to the project.
 ---
 
 <!-- BEGIN PLATFORM PREAMBLE · ui-design module · one block, byte-identical in every skill the module ships (vendored or rebuilt in-house) so an upstream refresh is a three-way merge; the source is modules/ui-design/skills/PREAMBLE.md and tests/ui_design_skills.mjs fails on drift -->

package/modules/ui-design/skills/imagegen-frontend-web/SKILL.md

@@ -5,6 +5,12 @@ description: >-
   objects and atmosphere backdrops for the slots a composition already has — never one per section, never a
   screen, never a UI comp, and no page code. One material, light and camera across the family, landed with a
   provenance sidecar. Triggers on "make a hero plate", "an atmosphere backdrop".
+plain: >-
+  Makes the large background or hero pictures for a web page, with no text in them.
+reach-for: >-
+  When a page needs its main picture or a background image.
+cost: >-
+  Paid: each image is made on the project's image key. It adds the picture files to the project.
 ---
 
 <!-- BEGIN PLATFORM PREAMBLE · ui-design module · one block, byte-identical in every skill the module ships (vendored or rebuilt in-house) so an upstream refresh is a three-way merge; the source is modules/ui-design/skills/PREAMBLE.md and tests/ui_design_skills.mjs fails on drift -->

package/modules/ui-design/skills/impeccable/SKILL.md

@@ -5,6 +5,12 @@ description: >-
   ("impeccable audit /projects"). Sixteen playbooks — shape, audit, critique, polish, harden, animate,
   typeset, colorize, layout, adapt, distill, clarify, onboard, optimize, document, extract — one per request.
   Triggers on "impeccable", "critique this page", "audit the UI". Web surfaces only.
+plain: >-
+  A toolbox of design checks and fixes for a web page, such as a review, a polish, better type or better layout, one job at a time.
+reach-for: >-
+  When you want a page reviewed or improved in one specific way.
+cost: >-
+  Uses your session. A review changes nothing; a fix changes the page.
 ---
 
 <!-- BEGIN PLATFORM PREAMBLE · ui-design module · one block, byte-identical in every skill the module ships (vendored or rebuilt in-house) so an upstream refresh is a three-way merge; the source is modules/ui-design/skills/PREAMBLE.md and tests/ui_design_skills.mjs fails on drift -->

package/modules/ui-design/skills/industrial-brutalist-ui/SKILL.md

@@ -5,6 +5,12 @@ description: >-
   per project (Swiss industrial print or dark tactical terminal, never mixed), massive uppercase display
   against tracked-out mono metadata, strict grid anchoring, zero corner rounding, halftone and scanline
   degradation inside the Kill Switch. Triggers on "brutalist", "industrial", "make it raw".
+plain: >-
+  Gives a page a raw, mechanical look, like a technical document or a control terminal.
+reach-for: >-
+  When you want a bold, stark look.
+cost: >-
+  Uses your session. It changes the page, and you check it on a preview.
 ---
 
 <!-- BEGIN PLATFORM PREAMBLE · ui-design module · one block, byte-identical in every skill the module ships (vendored or rebuilt in-house) so an upstream refresh is a three-way merge; the source is modules/ui-design/skills/PREAMBLE.md and tests/ui_design_skills.mjs fails on drift -->

package/modules/ui-design/skills/minimalist-ui/SKILL.md

@@ -5,6 +5,12 @@ description: >-
   whitespace first, a capped measure, one display job and one body job, exactly one hairline weight for every
   border, flat tile cards with no shadow, entry motion inside the Kill Switch. Triggers on "make it minimal",
   "clean and editorial", "this feels busy". Declines dense surfaces.
+plain: >-
+  Gives a page a calm, clean look built from text and white space.
+reach-for: >-
+  When a page feels too busy.
+cost: >-
+  Uses your session. It changes the page, and you check it on a preview.
 ---
 
 <!-- BEGIN PLATFORM PREAMBLE · ui-design module · one block, byte-identical in every skill the module ships (vendored or rebuilt in-house) so an upstream refresh is a three-way merge; the source is modules/ui-design/skills/PREAMBLE.md and tests/ui_design_skills.mjs fails on drift -->

package/modules/ui-design/skills/redesign-existing-projects/SKILL.md

@@ -5,6 +5,12 @@ description: >-
   breaking it. Three fixed steps — scan the stack, diagnose against a written audit, apply targeted fixes —
   with the instance's world as the answer key and a fixed impact-per-risk fix order. Triggers on "redesign
   this", "upgrade the existing page", "audit this UI".
+plain: >-
+  Improves the look of an existing site in place, without rebuilding it or breaking what works.
+reach-for: >-
+  When an existing page or app needs a visual upgrade.
+cost: >-
+  Uses your session. It changes the existing pages, and you check them on a preview.
 ---
 
 <!-- BEGIN PLATFORM PREAMBLE · ui-design module · one block, byte-identical in every skill the module ships (vendored or rebuilt in-house) so an upstream refresh is a three-way merge; the source is modules/ui-design/skills/PREAMBLE.md and tests/ui_design_skills.mjs fails on drift -->

package/modules/ui-design/skills/stitch-design-taste/SKILL.md

@@ -5,6 +5,12 @@ description: >-
   platform's own frontmatter shape. Four dials with named bands and stated defaults, then eight fixed sections
   pairing descriptive language with exact values. The thirteen colours are transcribed from the instance's
   pack, never invented. Triggers on "a design brief for Stitch".
+plain: >-
+  Writes a design brief in the project's style for an outside screen-design tool such as Google Stitch.
+reach-for: >-
+  When you want to design screens in Stitch using the project's look.
+cost: >-
+  Uses your session. It writes one brief document and changes no pages.
 ---
 
 <!-- BEGIN PLATFORM PREAMBLE · ui-design module · one block, byte-identical in every skill the module ships (vendored or rebuilt in-house) so an upstream refresh is a three-way merge; the source is modules/ui-design/skills/PREAMBLE.md and tests/ui_design_skills.mjs fails on drift -->

package/modules/ui-design/skills/style/SKILL.md

@@ -5,6 +5,12 @@ description: >-
   the fifteen-token contract, and proves it clean before it lands. Four steps and no more — SEARCH, CREATE,
   PROVE, ADOPT. Triggers on "/style", "make a look", "author a style", "I want our own theme", "add a style to
   the library".
+plain: >-
+  A short guided session for creating your own look for the project, checked before it is used.
+reach-for: >-
+  When you want the project to have its own theme.
+cost: >-
+  Uses your session. The new look is only used once you choose to adopt it.
 ---
 
 <!-- BEGIN PLATFORM PREAMBLE · ui-design module · one block, byte-identical in every skill the module ships (vendored or rebuilt in-house) so an upstream refresh is a three-way merge; the source is modules/ui-design/skills/PREAMBLE.md and tests/ui_design_skills.mjs fails on drift -->

package/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@bongos/core",
-  "version": "1.20.9",
+  "version": "1.20.11",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@bongos/core",
-      "version": "1.20.9",
+      "version": "1.20.11",
       "license": "AGPL-3.0-or-later",
       "dependencies": {
         "express": "^4.21.2",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bongos/core",
-  "version": "1.20.9",
+  "version": "1.20.11",
   "description": "Cloud Bongos — the AI-first build platform core (GDS + platform surfaces + module system), installed as a versioned dependency (ADR 0108).",
   "license": "AGPL-3.0-or-later",
   "main": "src/platform-server.js",

package/release-notes.json

@@ -8106,5 +8106,17 @@
       "id": "1003268",
       "text": "Added three database lookups so the 'who have I worked near' view stays fast as the project grows. Nothing changes on screen today."
     }
+  ],
+  "1.20.10": [
+    {
+      "id": "1004403",
+      "text": "When you adopt a speciality, each skill it offers is now explained in plain words: what it does, when you would use it, and what it costs, including which ones spend money. Before, those explanations were guessed from technica"
+    }
+  ],
+  "1.20.11": [
+    {
+      "id": "1004404",
+      "text": "You can now choose which skills your speciality offers from Settings, not just through the API. You can do it when you create the speciality or later from its card. Each skill is listed with a plain description and what it cos"
+    }
   ]
 }

package/scripts/hall-preview/server.js

@@ -164,6 +164,10 @@ const CANNED_WRITES = [
   // opens the skills walkthrough and its recap can save in the harness.
   ['POST', /^specialities\/\d+\/adopt$/, 'specialities__9__adopt.post'],
   ['PUT', /^specialities\/\d+\/skills$/, 'specialities__9__skills.put'],
+  // the owner choosing what a speciality offers (task 1004404): on create, and
+  // afterwards from the card's "Offered skills" editor.
+  ['POST', /^specialities$/, 'specialities.post'],
+  ['PATCH', /^specialities\/\d+$/, 'specialities__12.patch'],
 ];
 
 // A DATE THAT ROTS CANNOT DEMO AN AGE SIGNAL (task 1004041). The help-request

package/src/module-api.js

@@ -75,7 +75,7 @@ const { responsibilityFor, ROLE_RESPONSIBILITIES } = require('./role-responsibil
 // MAJOR (see allowBoxScope below): passes the request through untouched.
 function deprecatedNoopMiddleware(_req, _res, next) { next(); }
 
-const CORE_VERSION = '1.20.9'; // CI auto-patch carrier (ADR 0161); changelog: docs/module-api-changelog.md
+const CORE_VERSION = '1.20.11'; // CI auto-patch carrier (ADR 0161); changelog: docs/module-api-changelog.md
 
 // A namespaced logger so a module's log lines are attributable + consistent.
 // Usage: const log = api.logger('discord'); log.info('mounted');