@groeponline/pi-wishcraft 0.27.0 → 0.27.2

package/AGENTS.md

@@ -57,6 +57,8 @@ user customization.
 - **Bun/Node-native TS:** `import` paths carry `.ts` extensions
   (`allowImportingTsExtensions`), `node:`-prefixed builtins, `node --test`
   with type stripping. No build step.
+- **English UI:** operator overlays, notify strings, and `/wishcraft` copy are
+  English. Do not add Dutch UI strings.
 - **Tests:** behavior changes in `src/` need a focused regression test near
   the existing tests for that subsystem; structural tests assert on module
   files in `src/` (never `index.ts`).

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 ## [Unreleased]
 
+## [0.27.2] - 2026-08-20
+
+### Added
+- `examples/settings.example.json` — every setting at its default, including
+  `wishcraft.policy`, `readHints`, and other post-0.22 keys.
+- ROADMAP top-15 maturity track rebaselined on 0.27.x (English); landed
+  0.23–0.27 items moved to "Already shipped".
+
+## [0.27.1] - 2026-08-20
+
+### Changed
+- Operator UI is English: skill manager, `/wishcraft` TUI, overlay empty-match row, and skill-health warnings.
+
 ## [0.27.0] - 2026-08-20
 
 ### Added

package/README.md

@@ -91,7 +91,7 @@ Keybinds (`powerlineShortcuts`, applied after `/reload`; `null` disables):
 }
 ```
 
-`chef` is muted colors, slash separators, live TPS in/out, and TCP port count. Built-in presets: `default`, `minimal`, `compact`, `full`, `nerd`, `ascii`, `chef`. Custom segments, labels, layout, and presets are documented in [docs/configuration.md](docs/configuration.md).
+`chef` is muted colors, slash separators, live TPS in/out, and TCP port count. Built-in presets: `default`, `minimal`, `compact`, `full`, `nerd`, `ascii`, `chef`. Custom segments, labels, layout, and presets are documented in [docs/configuration.md](docs/configuration.md). For every setting at its default, see [`examples/settings.example.json`](examples/settings.example.json).
 
 Nerd Fonts auto-detect for iTerm, WezTerm, Kitty, Ghostty, and Alacritty; ASCII otherwise. `POWERLINE_NERD_FONTS=0` forces ASCII.
 

package/ROADMAP.md

@@ -98,6 +98,63 @@ Niet de fork. Niet de SaaS-agent.
   documentatie die waar is. Done = README dekt alles wat we shipten,
   geen kapotte footer-belofte.
 
+## Top-15 track: remaining maturity gaps
+
+Written 2026-08-20, rebaselined on 0.27.1 (code review, not this ROADMAP
+alone). Feature density is high; several original gaps closed in
+0.23–0.27. What remains is the maturity layer that separates a top-15 pi
+extension from a feature-rich prototype.
+
+### Already shipped (0.22.x–0.27.x)
+- **CHE-41 per-segment detail** — `→` in Navigate, snapshot on open (0.22.1).
+- **CHE-42 drill-down** — #19 + Configure in #13.
+- **Changelog roll** — version headers drive the what's-new panel.
+- **Per-segment fault isolation** — throwing custom segments show `!id`
+  instead of blanking the footer (#34, 0.23.1).
+- **macOS open_ports** — netstat dot-address parsing (#34, 0.23.1).
+- **GitHub Release per npm tag** (#25, 0.23.2).
+- **CodeQL proto-pollution hardening** (#27, 0.23.3).
+- **setupHooks wired** (#26, 0.23.4).
+- **Policy engine** — declarative deny/inject, no spawn (GRO-1418, #29,
+  0.24.0).
+- **`/skills doctor`** — broken frontmatter, dupes, unused, budget
+  (GRO-1416, #28, 0.24.0 / 0.25.0 tag).
+- **`/skills new` templates** — no marketplace (GRO-1417, #32, 0.26.0).
+- **`/ideas` review overlay** — status, tags, skill insert (GRO-1419, #31,
+  0.27.0).
+- **English operator UI** — overlays, skill manager, `/wishcraft` TUI
+  (GRO-1422, #24, 0.27.1).
+- **`powerline.skills.count` + read hints + Status trim** (GRO-1420, 0.23.0).
+
+### Remaining open gaps (maturity)
+P0 — release gate for 1.0:
+1. **Settings contract to pi core.** No `contributes.settings`/schema;
+   users hand-edit JSON. *Fix: typed settings schema + contributions.*
+
+P1 — differentiation and quality:
+2. **Zero-config first run.** Install still expects JSON edits for the most
+   useful features. *Fix: sensible defaults + first-run setup overlay.*
+3. **Perf budget / low-power mode.** Status renders every ~33ms; heavy
+   segments (bash-history, git) can hit the hot path. *Fix: configurable
+   refresh + lite mode.*
+4. **Accessibility (no-color / reduced-motion).** Truecolor + animations
+   (vibes, rainbow think) break on terminals without truecolor. *Fix:
+   `NO_COLOR`/8-color + reduced-motion respect.*
+5. **Semver policy / public API stability.** Still 0.x; top-15 extensions
+   ship a stability contract + deprecation path. *Fix: documented API
+   surface + semver policy. **1.0 cut: GRO-1421 (next).***
+
+P2 — full product, post-1.0 or ride-along on GRO-1415:
+6. **Preset editor in-menu** — custom JSON-only today.
+7. **Skill install from repo/npm** — discovery + doctor exist; install and
+   curate missing.
+8. **Host-status integration** — `ctx.ui.setStatus` beside the footer so
+   status also shows in host UI (`skills.count` is a start; full coverage
+   remains).
+
+Linear tickets for open gaps are still to be filed (not invented in this
+ROADMAP).
+
 ---
 
 ## 0.19.0 — Correctheid
@@ -219,50 +276,49 @@ de zes gevallen + de parse-vóór-wrap invariant.
 
 ### PR G — overlay-submenus (CHE-42) — ✅ #19 + expansion (#13 reopen)
 
-Het `alt+p`-menu krijgt gestapelde `SelectList`-overlays (pijltjes +
-descriptions) in plaats van platte `ctx.ui.select`. Max drie
-top-level ingangen. #19 landt de top-level boom (Navigate / Configure /
-Status). Configure gebruikt nu `showSelectOverlay` (CHE-42 rest). CHE-40
-is Done (#18). CHE-41 is Done: `→` in Navigate, snapshot bij openen, geen tweede `alt+i`-pad.
+The `alt+p` menu gets stacked `SelectList` overlays (arrows +
+descriptions) instead of flat `ctx.ui.select`. Maximum three top-level
+entries. #19 lands the top-level tree (Navigate / Configure /
+Status). Configure now uses `showSelectOverlay` (CHE-42 remainder). CHE-40
+is Done (#18). CHE-41 is Done: `→` in Navigate, snapshot on open, no second `alt+i` path.
 
 ### PR H — skills manager v2 UI + token-overlays
 
-Vervangt `skill-manager.ts` (242 regels). Data-laag bouwt op Pi
+Replaces `skill-manager.ts` (242 lines). The data layer builds on Pi
 core `loadSkills` / `loadSkillsFromDir` / `Skill` /
-`SkillFrontmatter` (publiek geëxporteerd in
+`SkillFrontmatter` (publicly exported in
 `@earendil-works/pi-coding-agent`).
 
-UI, niet onderhandelbaar:
-
-- Zoeken die werkt: substring op naam + beschrijving + pad,
-  case-insensitive; `ctrl+u` wist; lege match = rij
-  `geen skills voor '<q>'`.
-- Categorieën met kopregels (bundled / global / project / prompts);
-  `tab` wisselt filter; `s` sorteert naam ↔ gebruik.
-- `→` detail (frontmatter-tabel, usage, pad, body + scroll);
-  `enter` insert; `e` opent `$EDITOR` (default nvim) via extern
-  spawn zoals pi's `!`; `n` nieuwe skill in
-  `~/.pi/agent/skills/<naam>/SKILL.md`; `d` delete + confirm.
-- Usage-ledger `~/.pi/agent/skill-usage.json` (naam, timestamp,
-  trigger-type). Best-effort, nooit blokkerend op de input hot path.
-- Skill health: core-diagnostics als waarschuwingsicoon; `?` legt
-  het uit.
-
-Zelfde chrome als de segment-navigator. Nederlands, direct.
-
-Tegelijk, klein:
-
-- `/tps` overlay: in/out, piek + gemiddelde over de bestaande ring.
-  Geen nieuwe sampler.
-- `/usage` overlay: vandaag / deze week / deze sessie; per model;
-  cache-hit %; ASCII-sparkline. File
-  `~/.pi/agent/wishcraft-usage.json` (append-only, compaction bij
-  drempel).
-- `wishcraft.tokenBudget.daily` kleurt het segment rood en waarschuwt
-  in welcome bij 80% / 100%. Nooit blokkerend.
-
-Done: filter-tests op substring; usage-ledger tests; `/tps` leest
-dezelfde ring als het segment (geen tweede waarheid).
+UI, non-negotiable:
+
+- Working search: substring on name + description + path,
+  case-insensitive; `ctrl+u` clears; empty match = row
+  `no skills for '<q>'`.
+- Categories with headings (bundled / global / project / prompts);
+  `tab` switches the filter; `s` sorts name ↔ usage.
+- `→` detail (frontmatter table, usage, path, body + scroll);
+  `enter` inserts; `e` opens `$EDITOR` (default nvim) via external
+  spawn like pi's `!`; `n` creates a new skill in
+  `~/.pi/agent/skills/<name>/SKILL.md`; `d` delete + confirm.
+- Usage-ledger `~/.pi/agent/skill-usage.json` (name, timestamp,
+  trigger type). Best-effort, never blocking on the input hot path.
+- Skill health: core-diagnostics as a warning icon; `?` explains it.
+
+Same chrome as the segment navigator. English, direct.
+
+At the same time, small additions:
+
+- `/tps` overlay: in/out, peak + average over the existing ring.
+  No new sampler.
+- `/usage` overlay: today / this week / this session; per model;
+  cache-hit %; ASCII sparkline. File
+  `~/.pi/agent/wishcraft-usage.json` (append-only, compaction at
+  threshold).
+- `wishcraft.tokenBudget.daily` colors the segment red and warns
+  in the welcome at 80% / 100%. Never blocking.
+
+Done: substring filter tests; usage-ledger tests; `/tps` reads
+the same ring as the segment (no second source of truth).
 
 ---
 
@@ -314,7 +370,9 @@ die package nog leeft.
 
 ## Kwaliteit (altijd)
 
-- Overlay-logica testbaar via pure functies. Geen headless `ctx.ui`.
+- Overlay logic is testable via pure functions. No headless `ctx.ui`.
+- **English UI:** operator overlays, notify strings, and `/wishcraft` copy are
+  English. Do not add Dutch UI strings.
 - `prepublishOnly` = `tsc --noEmit`. Een slecht type ship't niet.
 - `madge --circular` blijft CI. Nieuwe map in `src/` → check mee.
 - Dependabot-vulns (devDep-transitief): waiven, track op GRO-603.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@groeponline/pi-wishcraft",
-  "version": "0.27.0",
+  "version": "0.27.2",
   "description": "Wishcraft cockpit for the pi coding agent — powerline status, vibes, idea inbox, bash mode, and full customization.",
   "type": "module",
   "files": [

package/src/extension/settings/wishcraft-config.ts

@@ -1,11 +1,10 @@
 /**
  * wishcraft-config.ts
  * ---------------------------------------------------------------------------
- * `/wishcraft` — één configuratie-TUI voor álle wishcraft-instellingen:
- * overzichtelijk per groep én direct aanpasbaar (toggle, keuze, tekst,
- * getal), live weggeschreven naar settings en direct zichtbaar.
- * Data-driven: instellingen worden gedeclareerd als ConfigItem[]; de overlay
- * rendert en bewerkt ze generiek.
+ * `/wishcraft` — one configuration TUI for every wishcraft setting:
+ * grouped, directly editable (toggle, choice, text, number), written live
+ * to settings and visible immediately. Data-driven: settings are declared
+ * as ConfigItem[]; the overlay renders and edits them generically.
  * ---------------------------------------------------------------------------
  */
 
@@ -24,17 +23,17 @@ import { parsePowerlineConfig } from "../../config/powerline-config.ts";
 export type ConfigValue = boolean | string | number | null;
 
 export interface ConfigItem {
-  /** Label in de lijst. */
+  /** Label in the list. */
   label: string;
-  /** Pad binnen settings ("powerline.placement", "wishcraft.hooksEnabled", ...). */
+  /** Path inside settings ("powerline.placement", "wishcraft.hooksEnabled", ...). */
   path: string;
-  /** Bewerkingsoptype. */
+  /** Edit kind. */
   kind: "toggle" | "select" | "text" | "number";
-  /** Voor select: de keuzes. */
+  /** For select: the choices. */
   choices?: string[];
-  /** Hulpregels onder de groep. */
+  /** Hint under the group. */
   hint?: string;
-  /** Uitleg bij het item in detail (optioneel). */
+  /** Detail explanation (optional). */
   description?: string;
 }
 
@@ -43,7 +42,7 @@ export interface ConfigGroup {
   items: ConfigItem[];
 }
 
-/** Genest uitlezen: "wishcraft.hooksEnabled" → settings.wishcraft.hooksEnabled. */
+/** Nested read: "wishcraft.hooksEnabled" → settings.wishcraft.hooksEnabled. */
 export function readConfigPath(settings: Record<string, unknown>, path: string): ConfigValue {
   let cur: unknown = settings;
   for (const part of path.split(".")) {
@@ -130,61 +129,61 @@ const SEPARATORS = [
   "star",
 ];
 
-/** Bouw de groepen op basis van huidige settings (waarden live getoond). */
+/** Build groups from current settings (values shown live). */
 export function buildConfigGroups(settings: Record<string, unknown>): ConfigGroup[] {
   return [
     {
-      title: "Statusbalk",
+      title: "Status bar",
       items: [
         { label: "Preset", path: "powerline.preset", kind: "select", choices: ["default", "minimal", "compact", "full", "nerd", "ascii", "chef"] },
         { label: "Separator", path: "powerline.separator", kind: "select", choices: SEPARATORS },
-        { label: "Plaatsing", path: "powerline.placement", kind: "select", choices: ["above", "below"] },
-        { label: "Pad-modus", path: "powerline.segmentOptions.path.mode", kind: "select", choices: ["basename", "abbreviated", "full"] },
-        { label: "Pad-maxlengte", path: "powerline.segmentOptions.path.maxLength", kind: "number", hint: "0 = onbeperkt" },
-        { label: "Tijd formaat", path: "powerline.segmentOptions.time.format", kind: "select", choices: ["12h", "24h"] },
-        { label: "Tijd seconden", path: "powerline.segmentOptions.time.showSeconds", kind: "toggle" },
-        { label: "Git host-iconen", path: "powerline.segmentOptions.git.hostIcon", kind: "toggle" },
+        { label: "Placement", path: "powerline.placement", kind: "select", choices: ["above", "below"] },
+        { label: "Path mode", path: "powerline.segmentOptions.path.mode", kind: "select", choices: ["basename", "abbreviated", "full"] },
+        { label: "Path max length", path: "powerline.segmentOptions.path.maxLength", kind: "number", hint: "0 = unlimited" },
+        { label: "Time format", path: "powerline.segmentOptions.time.format", kind: "select", choices: ["12h", "24h"] },
+        { label: "Time seconds", path: "powerline.segmentOptions.time.showSeconds", kind: "toggle" },
+        { label: "Git host icons", path: "powerline.segmentOptions.git.hostIcon", kind: "toggle" },
         { label: "Git ahead/behind", path: "powerline.segmentOptions.git.showAheadBehind", kind: "toggle" },
-        { label: "Git laatste commit", path: "powerline.segmentOptions.git.showCommit", kind: "toggle" },
-        { label: "Context formaat", path: "powerline.segmentOptions.context.format", kind: "select", choices: ["full", "percent"] },
-        { label: "Cache-read formaat", path: "powerline.segmentOptions.cache_read.format", kind: "select", choices: ["tokens", "percent", "both"] },
-        { label: "Kosten toning", path: "powerline.segmentOptions.cost.subscriptionDisplay", kind: "select", choices: ["subscription", "reported-cost", "both"] },
-        { label: "Valuta", path: "powerline.segmentOptions.cost.currency", kind: "text" },
-        { label: "Ports incl. UDP", path: "powerline.segmentOptions.openPorts.includeUdp", kind: "toggle" },
-        { label: "TPS venster (ms)", path: "powerline.segmentOptions.tps.windowMs", kind: "number", hint: "default 1000" },
-        { label: "TPS modus", path: "powerline.segmentOptions.tps.mode", kind: "select", choices: ["both", "out", "in"] },
-        { label: "TPS label", path: "powerline.segmentLabels.tps", kind: "text", hint: "leeg = geen label" },
+        { label: "Git latest commit", path: "powerline.segmentOptions.git.showCommit", kind: "toggle" },
+        { label: "Context format", path: "powerline.segmentOptions.context.format", kind: "select", choices: ["full", "percent"] },
+        { label: "Cache-read format", path: "powerline.segmentOptions.cache_read.format", kind: "select", choices: ["tokens", "percent", "both"] },
+        { label: "Cost display", path: "powerline.segmentOptions.cost.subscriptionDisplay", kind: "select", choices: ["subscription", "reported-cost", "both"] },
+        { label: "Currency", path: "powerline.segmentOptions.cost.currency", kind: "text" },
+        { label: "Ports include UDP", path: "powerline.segmentOptions.openPorts.includeUdp", kind: "toggle" },
+        { label: "TPS window (ms)", path: "powerline.segmentOptions.tps.windowMs", kind: "number", hint: "default 1000" },
+        { label: "TPS mode", path: "powerline.segmentOptions.tps.mode", kind: "select", choices: ["both", "out", "in"] },
+        { label: "TPS label", path: "powerline.segmentLabels.tps", kind: "text", hint: "empty = no label" },
       ],
     },
     {
-      title: "Welkom & vibes",
+      title: "Welcome & vibes",
       items: [
-        { label: "Welcome overlay", path: "powerline.welcome", kind: "toggle", hint: "aan = overlay bij opstart, uit = geen welcome" },
-        { label: "Wishcraft-ballon animeren", path: "wishcraft.welcome.animateLantern", kind: "toggle", hint: "flikker-effect op de wensballon" },
+        { label: "Welcome overlay", path: "powerline.welcome", kind: "toggle", hint: "on = overlay at startup, off = no welcome" },
+        { label: "Animate wishcraft lantern", path: "wishcraft.welcome.animateLantern", kind: "toggle", hint: "flicker on the lantern" },
       ],
     },
     {
       title: "Skills",
       items: [
-        { label: "Inline-expansie /command en $skill", path: "wishcraft.inlineSkills", kind: "toggle", hint: "nog niet actief zonder herstart" },
+        { label: "Inline expand /command and $skill", path: "wishcraft.inlineSkills", kind: "toggle", hint: "needs a restart to take effect" },
         { label: "Read hints", path: "wishcraft.readHints", kind: "toggle", hint: "off = no continuation hint after partial reads" },
       ],
     },
     {
-      title: "Hooks & repairs (harness-laag)",
+      title: "Hooks & repairs (harness)",
       items: [
-        { label: "Hooks ingeschakeld", path: "wishcraft.hooksEnabled", kind: "toggle", hint: "commandcode-achtige preToolUse/postToolUse/sessionStart hooks" },
+        { label: "Hooks enabled", path: "wishcraft.hooksEnabled", kind: "toggle", hint: "preToolUse / postToolUse / sessionStart command hooks" },
         { label: "Tool-input repairs", path: "wishcraft.repairsEnabled", kind: "toggle", hint: "null-for-optional, auto-link, json-array, path aliases" },
-        { label: "Dagelijks tokenbudget", path: "wishcraft.tokenBudget.daily", kind: "number", hint: "kleurt cost-segment; blokkeert nooit. 0 = uit" },
+        { label: "Daily token budget", path: "wishcraft.tokenBudget.daily", kind: "number", hint: "colours the cost segment; never blocks. 0 = off" },
       ],
     },
     {
-      title: "Sneltoetsen",
+      title: "Shortcuts",
       items: [
-        { label: "Menu", path: "powerlineShortcuts.menu", kind: "text", hint: "bv. alt+p" },
+        { label: "Menu", path: "powerlineShortcuts.menu", kind: "text", hint: "e.g. alt+p" },
         { label: "Info", path: "powerlineShortcuts.info", kind: "text" },
         { label: "Stash", path: "powerlineShortcuts.stashHistory", kind: "text" },
-        { label: "Idee", path: "powerlineShortcuts.ideaCapture", kind: "text" },
+        { label: "Idea", path: "powerlineShortcuts.ideaCapture", kind: "text" },
         { label: "Queue", path: "powerlineShortcuts.queueOpen", kind: "text" },
       ],
     },
@@ -202,8 +201,8 @@ function isPrintable(data: string): boolean {
 }
 
 function displayValue(item: ConfigItem, value: ConfigValue): string {
-  if (value === null || value === undefined || value === "") return item.kind === "toggle" ? "uit" : "—";
-  if (item.kind === "toggle") return value ? "aan" : "uit";
+  if (value === null || value === undefined || value === "") return item.kind === "toggle" ? "off" : "—";
+  if (item.kind === "toggle") return value ? "on" : "off";
   return String(value);
 }
 
@@ -220,7 +219,7 @@ export async function showWishcraftConfig(rt: RuntimeState, ctx: any): Promise<v
   let settings = readSettings(cwd);
   let groups = buildConfigGroups(settings);
 
-  // platte rijenlijst: groepstitels + items
+  // flat row list: group titles + items
   type Row =
     | { type: "group"; title: string }
     | { type: "item"; group: number; item: ConfigItem };
@@ -239,7 +238,7 @@ export async function showWishcraftConfig(rt: RuntimeState, ctx: any): Promise<v
       const wrapRow = (t: string, w: number) =>
         `${border("│")}${truncateToWidth(t, w, "…", true)}${border("│")}`;
 
-      let selected = 1; // eerste item (rij 0 is een groepstitel)
+      let selected = 1; // first item (row 0 is a group title)
       let editing = false;
       let editBuffer = "";
 
@@ -254,12 +253,12 @@ export async function showWishcraftConfig(rt: RuntimeState, ctx: any): Promise<v
         if (!cur) return;
         const { item } = cur;
         let value: ConfigValue;
-        if (item.kind === "toggle") value = next === "aan";
+        if (item.kind === "toggle") value = next === "on";
         else value = coerce(item, readConfigPath(settings, item.path), next);
         const ok = writeConfigPath(cwd, item.path, value);
         settings = readSettings(cwd);
         groups = buildConfigGroups(settings);
-        // live herladen powerline-config + statusbalk
+        // live-reload powerline config + status bar
         if (item.path.startsWith("powerline")) {
           setConfig({
             ...stateConfig,
@@ -268,7 +267,7 @@ export async function showWishcraftConfig(rt: RuntimeState, ctx: any): Promise<v
           rt.tuiRef?.requestRender?.();
         }
         ctx.ui.notify(
-          ok ? `${item.label}: ${displayValue(item, value)} (opgeslagen)` : `${item.label} niet opgeslagen (settings.json?)`,
+          ok ? `${item.label}: ${displayValue(item, value)} (saved)` : `${item.label} not saved (settings.json?)`,
           ok ? "info" : "warning",
         );
       };
@@ -282,7 +281,7 @@ export async function showWishcraftConfig(rt: RuntimeState, ctx: any): Promise<v
         settings = readSettings(cwd);
         groups = buildConfigGroups(settings);
         ctx.ui.notify(
-          ok ? `${item.label}: ${next} (opgeslagen)` : `${item.label} niet opgeslagen`,
+          ok ? `${item.label}: ${next} (saved)` : `${item.label} not saved`,
           ok ? "info" : "warning",
         );
       };
@@ -293,7 +292,7 @@ export async function showWishcraftConfig(rt: RuntimeState, ctx: any): Promise<v
         settings = readSettings(cwd);
         groups = buildConfigGroups(settings);
         ctx.ui.notify(
-          ok ? `${item.label}: ${!(cur === true) ? "aan" : "uit"} (opgeslagen)` : `${item.label} niet opgeslagen`,
+          ok ? `${item.label}: ${!(cur === true) ? "on" : "off"} (saved)` : `${item.label} not saved`,
           ok ? "info" : "warning",
         );
       };
@@ -304,12 +303,12 @@ export async function showWishcraftConfig(rt: RuntimeState, ctx: any): Promise<v
           const lines: string[] = [];
           lines.push(border(`╭${"─".repeat(innerWidth)}╮`));
           lines.push(
-            wrapRow(theme.fg("accent", theme.bold("Wishcraft · configuratie")), innerWidth),
+            wrapRow(theme.fg("accent", theme.bold("Wishcraft · configuration")), innerWidth),
           );
           lines.push(border(`├${"─".repeat(innerWidth)}┤`));
 
           const rows = buildRows();
-          // scroll-venster rondom selectie
+          // scroll window around the selection
           let start = Math.max(0, selected - Math.floor(LIST_ROWS / 2));
           let end = Math.min(start + LIST_ROWS, rows.length);
           if (end - start < Math.min(LIST_ROWS, rows.length)) start = Math.max(0, end - LIST_ROWS);
@@ -341,8 +340,8 @@ export async function showWishcraftConfig(rt: RuntimeState, ctx: any): Promise<v
               theme.fg(
                 "dim",
                 editing
-                  ? "typ=waarde · enter=opslaan · esc=annuleren"
-                  : "↑↓ · enter=kiezen/bewerken (←→ wisselt) · esc=sluiten",
+                  ? "type=value · enter=save · esc=cancel"
+                  : "↑↓ · enter=select/edit (←→ cycles) · esc=close",
               ),
               innerWidth,
             ),
@@ -388,7 +387,7 @@ export async function showWishcraftConfig(rt: RuntimeState, ctx: any): Promise<v
             } while (rows[selected]!.type === "group");
           } else if (matchesKey(data, "pageUp")) {
             selected = Math.max(1, selected - LIST_ROWS);
-            // niet op een groepskop landen: schuif door naar het volgende item
+            // do not land on a group header: skip to the next item
             while (selected < rows.length - 1 && rows[selected]!.type === "group")
               selected++;
           } else if (matchesKey(data, "pageDown")) {
@@ -424,10 +423,10 @@ export async function showWishcraftConfig(rt: RuntimeState, ctx: any): Promise<v
   );
 }
 
-/** Registreer /wishcraft. */
+/** Register /wishcraft. */
 export function registerWishcraftConfigCommand(pi: ExtensionAPI, rt: RuntimeState): void {
   pi.registerCommand("wishcraft", {
-    description: "Configureer alles van wishcraft in één overzicht (statusbalk, welcome, hooks, sneltoetsen)",
+    description: "Configure all wishcraft settings in one overlay (status bar, welcome, hooks, shortcuts)",
     handler: async (_args: string, ctx: any) => {
       if (!rt.enabled || !ctx.hasUI) {
         ctx.ui.notify("Powerline UI is disabled", "info");

package/src/extension/skills/inline-invocation.ts

@@ -1,13 +1,13 @@
 /**
  * inline-invocation.ts
  * ------------------------------------------------------------------------
- * Inline trigger expansie zoals Cursor (met /) en Codex (met $).
+ * Inline trigger expansion like Cursor (`/`) and Codex (`$`).
  *
- *   /command -> vervangt door inhoud van command.md skill file
- *   $skill   -> vervangt door inhoud van skill.md skill file
+ *   /command -> replaced with the command.md skill body
+ *   $skill   -> replaced with the skill.md skill body
  *
- * Discovery en cache leven in skill-registry.ts (pi core loadSkills + TTL),
- * zodat nieuwe skills zonder herstart werken en usage bijgehouden wordt.
+ * Discovery and cache live in skill-registry.ts (pi core loadSkills + TTL)
+ * so new skills work without a restart and usage is tracked.
  * ------------------------------------------------------------------------
  */
 
@@ -64,7 +64,7 @@ function isExcluded(index: number, ranges: Array<[number, number]>): boolean {
 export function expandInlineTriggers(text: string): string {
   const availableSkills = getAvailableSkills();
 
-  // Pattern voor zowel /command als $skill
+  // Pattern for both /command and $skill
   const TRIGGER_REGEX = /(^|[\s(])(\/|\$)([a-zA-Z0-9_-]+)/g;
   const excluded = findExcludedRanges(text);
 
@@ -96,7 +96,7 @@ export function expandInlineTriggers(text: string): string {
   // Geen matches -> originele tekst teruggeven
   if (matches.length === 0) return text;
 
-  // Sorteer op positie en verwijder overlappingen
+  // Sort by position and drop overlaps
   matches.sort((a, b) => a.start - b.start);
   const deduped: typeof matches = [];
   let lastEnd = -1;
@@ -107,7 +107,7 @@ export function expandInlineTriggers(text: string): string {
     }
   }
 
-  // Bouw nieuwe tekst op met expansies
+  // Rebuild the text with expansions
   let result = "";
   let cursor = 0;
 
@@ -160,7 +160,7 @@ export function setupInlineInvocation(
     return { action: "continue" };
   });
 
-  // Cache verversen bij herstart/reload zodat nieuwe skills meteen zichtbaar zijn
+  // Refresh the cache on restart/reload so new skills show up immediately
   pi.on("session_start", () => {
     invalidateSkillCache();
   });

package/src/extension/skills/skill-manager.ts

@@ -1,13 +1,13 @@
 /**
  * skill-manager.ts
  * ---------------------------------------------------------------------------
- * Skills Manager v2 — volledig eigen TUI-overlay (lijst ⇄ detail) met:
- *   - zoeken dat echt filtert (type=filter, ctrl+u wist)
- *   - categorie-koppen (global/project/prompts/extra) + tab-categoriefilter
- *   - sorteren op naam of gebruik (s), usage-counts uit de ledger
- *   - detail-paneel: metadata, frontmatter, body met scroll
- *   - e=bewerken (edit-commando in de editor via pi's !-flow),
- *     n=nieuwe skill, d=verwijderen met confirm
+ * Skills Manager v2 — list ⇄ detail overlay:
+ *   - search that actually filters (type=filter, ctrl+u clears)
+ *   - category headers (global/project/prompts/extra) + tab category filter
+ *   - sort by name or usage (s), usage counts from the ledger
+ *   - detail panel: metadata, frontmatter, body with scroll
+ *   - e=edit (edit command in the editor via pi's ! flow),
+ *     n=new skill, d=delete with confirm
  * ---------------------------------------------------------------------------
  */
 
@@ -30,7 +30,7 @@ import { runSkillDoctor } from "./skill-doctor.ts";
 import { runSkillsNew } from "./skill-templates.ts";
 
 const CATEGORY_LABELS: Record<SkillCategory | "all", string> = {
-  all: "alles",
+  all: "all",
   global: "global",
   project: "project",
   prompts: "prompts",
@@ -59,18 +59,18 @@ function formatBytes(n: number): string {
 }
 
 function formatLastUsed(ms: number): string {
-  if (!ms) return "nooit";
+  if (!ms) return "never";
   const diff = Date.now() - ms;
   const min = Math.floor(diff / 60_000);
-  if (min < 1) return "zojuist";
-  if (min < 60) return `${min}m geleden`;
+  if (min < 1) return "just now";
+  if (min < 60) return `${min}m ago`;
   const h = Math.floor(min / 60);
-  if (h < 24) return `${h}u geleden`;
+  if (h < 24) return `${h}h ago`;
   const d = Math.floor(h / 24);
-  return `${d}d geleden`;
+  return `${d}d ago`;
 }
 
-/** Voeg tekst toe aan de editor als nieuwe regel; de gebruiker drukt enter. */
+/** Append text as a new editor line; the user presses enter to run it. */
 function appendToEditor(ctx: any, text: string, notify: string): void {
   const current = ctx.ui.getEditorText?.() ?? "";
   const separator = current && !current.endsWith("\n") ? "\n" : "";
@@ -78,8 +78,8 @@ function appendToEditor(ctx: any, text: string, notify: string): void {
   ctx.ui.notify(notify, "info");
 }
 
-/** POSIX single-quote een pad zodat een skill-naam met shell-metatekens
- * (bv. `a; curl … | sh`, uit een untrusted gecloonde repo) niet injecteert. */
+/** POSIX single-quote a path so a skill name with shell metacharacters
+ * (e.g. `a; curl … | sh` from an untrusted cloned repo) cannot inject. */
 function shellQuote(value: string): string {
   return `'${value.replace(/'/g, `'"'"'`)}'`;
 }
@@ -144,10 +144,10 @@ export async function showSkillManager(ctx: any): Promise<"new" | null> {
           } else {
             rmSync(entry.filePath, { force: true });
           }
-          ctx.ui.notify(`Skill verwijderd: ${entry.name}`, "info");
+          ctx.ui.notify(`Skill deleted: ${entry.name}`, "info");
         } catch (error) {
           ctx.ui.notify(
-            `Verwijderen mislukt: ${error instanceof Error ? error.message : String(error)}`,
+            `Delete failed: ${error instanceof Error ? error.message : String(error)}`,
             "error",
           );
         }
@@ -160,7 +160,7 @@ export async function showSkillManager(ctx: any): Promise<"new" | null> {
 
       const insertBody = (entry: SkillEntry) => {
         insertSkillBody(ctx, entry.name, readSkillBody(entry.filePath));
-        ctx.ui.notify("Skill ingevoegd in je prompt", "info");
+        ctx.ui.notify("Skill inserted into your prompt", "info");
       };
 
       return {
@@ -171,8 +171,8 @@ export async function showSkillManager(ctx: any): Promise<"new" | null> {
 
           if (mode === "list") {
             const f = filtered();
-            // Kop: totaal + sort + live filter
-            const head = `Skills · ${f.length}/${entries.length} · ${sort === "name" ? "naam" : "gebruik"} · ${CATEGORY_LABELS[category]}${query ? ` · zoek "${query}"` : ""}`;
+            // Header: total + sort + live filter
+            const head = `Skills · ${f.length}/${entries.length} · ${sort === "name" ? "name" : "usage"} · ${CATEGORY_LABELS[category]}${query ? ` · search "${query}"` : ""}`;
             lines.push(wrapRow(theme.fg("accent", theme.bold(head)), innerWidth));
             lines.push(border(`├${"─".repeat(innerWidth)}┤`));
 
@@ -180,12 +180,12 @@ export async function showSkillManager(ctx: any): Promise<"new" | null> {
               const emptyMsg =
                 entries.length === 0 && !query
                   ? "No skills installed — ctrl+n to create one"
-                  : `Geen skills voor "${query}"`;
+                  : `No skills for "${query}"`;
               lines.push(
                 wrapRow(theme.fg("warning", emptyMsg), innerWidth),
               );
             } else {
-              // scroll-window rondom de selectie
+              // scroll window around the selection
               const start = Math.max(
                 0,
                 Math.min(selected - Math.floor(LIST_ROWS / 2), f.length - LIST_ROWS),
@@ -238,7 +238,7 @@ export async function showSkillManager(ctx: any): Promise<"new" | null> {
                 wrapRow(
                   theme.fg(
                     "warning",
-                    `ctrl+d of enter = verwijderen "${selectedEntry()?.name ?? ""}", andere toets = annuleren`,
+                    `ctrl+d or enter = delete "${selectedEntry()?.name ?? ""}", any other key cancels`,
                   ),
                   innerWidth,
                 ),
@@ -248,7 +248,7 @@ export async function showSkillManager(ctx: any): Promise<"new" | null> {
                 wrapRow(
                   theme.fg(
                     "dim",
-                    "typ=filter · ↑↓ · →/enter=detail · tab=categorie · ctrl+s=sort",
+                    "type=filter · ↑↓ · →/enter=detail · tab=category · ctrl+s=sort",
                   ),
                   innerWidth,
                 ),
@@ -257,7 +257,7 @@ export async function showSkillManager(ctx: any): Promise<"new" | null> {
                 wrapRow(
                   theme.fg(
                     "dim",
-                    "ctrl+e=bewerken · ctrl+n=nieuw · ctrl+d=verwijderen · esc=sluiten",
+                    "ctrl+e=edit · ctrl+n=new · ctrl+d=delete · esc=close",
                   ),
                   innerWidth,
                 ),
@@ -283,15 +283,15 @@ export async function showSkillManager(ctx: any): Promise<"new" | null> {
               );
             lines.push(
               meta(
-                "gebruikt",
-                `${u?.count ?? 0}× · laatste ${formatLastUsed(u?.lastUsed ?? 0)}`,
+                "used",
+                `${u?.count ?? 0}× · last ${formatLastUsed(u?.lastUsed ?? 0)}`,
               ),
             );
-            lines.push(meta("bestand", e.filePath));
+            lines.push(meta("file", e.filePath));
             lines.push(
               meta(
-                "omvang",
-                `${formatBytes(e.sizeBytes)} · ${e.lineCount} regels · gewijzigd ${formatLastUsed(e.mtimeMs)}`,
+                "size",
+                `${formatBytes(e.sizeBytes)} · ${e.lineCount} lines · changed ${formatLastUsed(e.mtimeMs)}`,
               ),
             );
             lines.push(
@@ -299,13 +299,13 @@ export async function showSkillManager(ctx: any): Promise<"new" | null> {
                 "frontmatter",
                 e.frontmatterKeys.length
                   ? e.frontmatterKeys.join(", ")
-                  : "(geen)",
+                  : "(none)",
               ),
             );
             if (e.disableModelInvocation) {
               lines.push(
                 wrapRow(
-                  theme.fg("warning", "model-invocatie uit — alleen handmatig"),
+                  theme.fg("warning", "model invocation off — insert only"),
                   innerWidth,
                 ),
               );
@@ -316,7 +316,7 @@ export async function showSkillManager(ctx: any): Promise<"new" | null> {
             lines.push(border(`├${"─".repeat(innerWidth)}┤`));
             const shown = bodyLines.slice(scroll, scroll + DETAIL_ROWS);
             if (shown.length === 0 || shown.join("").trim() === "") {
-              lines.push(wrapRow(theme.fg("dim", "(lege body)"), innerWidth));
+              lines.push(wrapRow(theme.fg("dim", "(empty body)"), innerWidth));
             }
             for (const line of shown) {
               lines.push(wrapRow(theme.fg("text", line || " "), innerWidth));
@@ -325,7 +325,7 @@ export async function showSkillManager(ctx: any): Promise<"new" | null> {
             if (confirmDelete) {
               lines.push(
                 wrapRow(
-                  theme.fg("warning", `ctrl+d of enter = verwijderen "${e.name}", andere toets = annuleren`),
+                  theme.fg("warning", `ctrl+d or enter = delete "${e.name}", any other key cancels`),
                   innerWidth,
                 ),
               );
@@ -334,7 +334,7 @@ export async function showSkillManager(ctx: any): Promise<"new" | null> {
                 wrapRow(
                   theme.fg(
                     "dim",
-                    "↑↓ scroll · enter=invoegen · ctrl+e=bewerken · ctrl+d=verwijderen · ←/esc=terug",
+                    "↑↓ scroll · enter=insert · ctrl+e=edit · ctrl+d=delete · ←/esc=back",
                   ),
                   innerWidth,
                 ),
@@ -356,7 +356,7 @@ export async function showSkillManager(ctx: any): Promise<"new" | null> {
           if (mode === "list") {
             const f = filtered();
             if (confirmDelete) {
-              // Bevestig verwijderen: ctrl+d of enter; elke andere toets annuleert.
+              // Confirm delete: ctrl+d or enter; any other key cancels.
               if (data === "\x04" || matchesKey(data, "enter")) {
                 const entry = selectedEntry();
                 if (entry) doDelete(entry);
@@ -375,17 +375,17 @@ export async function showSkillManager(ctx: any): Promise<"new" | null> {
               category = CATEGORY_ORDER[(idx + 1) % CATEGORY_ORDER.length]!;
               selected = 0;
             } else if (data === "\x13") {
-              // ctrl+s = sorteren
+              // ctrl+s = sort
               sort = sort === "name" ? "usage" : "name";
               selected = 0;
             } else if (data === "\x05") {
-              // ctrl+e = bewerken
+              // ctrl+e = edit
               const entry = selectedEntry();
               if (entry) {
                 appendToEditor(
                   ctx,
                   editorCommand(entry.filePath),
-                  "Edit-commando in de editor — enter draait 'm",
+                  "Edit command in the editor — press enter to run it",
                 );
                 close();
                 return;
@@ -395,7 +395,7 @@ export async function showSkillManager(ctx: any): Promise<"new" | null> {
               done("new");
               return;
             } else if (data === "\x04") {
-              // ctrl+d = verwijderen (met confirm)
+              // ctrl+d = delete (with confirm)
               if (selectedEntry()) confirmDelete = true;
             } else if (matchesKey(data, "enter") || matchesKey(data, "right")) {
               const entry = selectedEntry();
@@ -405,7 +405,7 @@ export async function showSkillManager(ctx: any): Promise<"new" | null> {
               matchesKey(data, "backspace") ||
               data === "\x15"
             ) {
-              // typen filtert; ctrl+u wist het filter
+              // typing filters; ctrl+u clears the filter
               if (data === "\x15") query = "";
               else if (matchesKey(data, "backspace")) query = query.slice(0, -1);
               else query += data;
@@ -429,16 +429,16 @@ export async function showSkillManager(ctx: any): Promise<"new" | null> {
                 scroll + 1,
               );
             } else if (data === "\x05") {
-              // ctrl+e = bewerken
+              // ctrl+e = edit
               appendToEditor(
                 ctx,
                 editorCommand(detail!.filePath),
-                "Edit-commando in de editor — enter draait 'm",
+                "Edit command in the editor — press enter to run it",
               );
               close();
               return;
             } else if (data === "\x04") {
-              // ctrl+d = verwijderen
+              // ctrl+d = delete
               confirmDelete = true;
             } else if (matchesKey(data, "enter") || matchesKey(data, "tab")) {
               insertBody(detail!);
@@ -460,7 +460,7 @@ export async function showSkillManager(ctx: any): Promise<"new" | null> {
   );
 }
 
-/** Registreer de `/skills` command. */
+/** Register the `/skills` command. */
 export type SkillManagerCommandDeps = {
   runDoctor?: (ctx: any) => Promise<void>;
 };
@@ -493,5 +493,5 @@ export function registerSkillManagerCommand(
   });
 }
 
-// Re-export voor compatibiliteit met bestaande importers/tests.
+// Re-export for existing importers/tests.
 export { listSkills, readSkillBody } from "./skill-registry.ts";

package/src/extension/skills/skill-registry.ts

@@ -1,11 +1,11 @@
 /**
  * skill-registry.ts
  * ---------------------------------------------------------------------------
- * Data-laag voor de skills manager v2: discovery via pi core's eigen
- * `loadSkills()` (recursieve SKILL.md-discovery, loose .md children,
- * SourceInfo, diagnostics) plus rijke metadata per skill en een
- * usage-ledger. Cache met TTL + expliciete invalidatie (session_start,
- * manager-open) zodat nieuwe skills zonder herstart zichtbaar worden.
+ * Data layer for skills manager v2: discovery via pi core `loadSkills()`
+ * (recursive SKILL.md discovery, loose .md children, SourceInfo,
+ * diagnostics) plus rich per-skill metadata and a usage ledger. Cache with
+ * TTL + explicit invalidation (session_start, manager-open) so new skills
+ * show up without a restart.
  * ---------------------------------------------------------------------------
  */
 
@@ -15,7 +15,7 @@ import { basename, dirname, join, relative } from "node:path";
 import { getAgentDir, getAgentPath } from "../../paths/agent-dirs.ts";
 import { parseSkillFrontmatter, stripFrontmatter } from "../../core/frontmatter.ts";
 
-/** Categorie: waar de skill vandaan komt. */
+/** Category: where the skill came from. */
 export type SkillCategory = "global" | "project" | "prompts" | "extra";
 
 export interface SkillUsage {
@@ -28,22 +28,22 @@ export interface SkillEntry {
   description: string;
   filePath: string;
   baseDir: string;
-  /** Alleen true voor core skills die een eigen skill-directory bezitten. */
+  /** True only for core skills that own a skill directory. */
   isDirectorySkill?: boolean;
   category: SkillCategory;
   disableModelInvocation: boolean;
   sizeBytes: number;
   lineCount: number;
   mtimeMs: number;
-  /** Alle frontmatter-keys (raw, inclusief onbekende). */
+  /** All frontmatter keys (raw, including unknown). */
   frontmatterKeys: string[];
-  /** Diagnostische melding (core diagnostics, of lege description). */
+  /** Diagnostic message (core diagnostics, or empty description). */
   warning?: string;
 }
 
-/** Losse .md/.txt in extra-dirs (prompts/legacy) die core weigert (geen
- * frontmatter-description). Core-dirs houden core's strenge regels; alleen
- * de extra dirs krijgen deze lakse fallback zodat oude prompts blijven werken. */
+/** Loose .md/.txt in extra dirs (prompts/legacy) that core rejects (no
+ * frontmatter description). Core dirs keep core's strict rules; only extra
+ * dirs get this lax fallback so old prompts keep working. */
 function scanLooseExtraFiles(
   extras: { path: string; category: SkillCategory }[],
   knownPaths: Set<string>,
@@ -82,7 +82,7 @@ function scanLooseExtraFiles(
         lineCount: content.split("\n").length,
         mtimeMs,
         frontmatterKeys: parseFrontmatterKeys(content),
-        warning: "geen description — model ziet deze skill niet in de prompt",
+        warning: "no description — the model will not see this skill in the prompt",
       });
       knownPaths.add(filePath);
     }
@@ -105,7 +105,7 @@ export function setSkillCacheInvalidationHandler(handler: (() => void) | null):
 const usageCache = new Map<string, SkillUsage>();
 let usageLoaded = false;
 
-/** Verwijder de discovery-cache (volgende leesactie scant opnieuw). */
+/** Drop the discovery cache (the next read scans again). */
 export function invalidateSkillCache(): void {
   cachedAt = 0;
   cachedEntries = null;
@@ -114,7 +114,7 @@ export function invalidateSkillCache(): void {
   onCacheInvalidated?.();
 }
 
-/** Legacy prompts/loose-md dirs die inline-invocation altijd al scanden. */
+/** Legacy prompts/loose-md dirs that inline-invocation already scanned. */
 function extraSkillPaths(cwd: string): { path: string; category: SkillCategory }[] {
   const agent = getAgentDir();
   return [
@@ -144,7 +144,7 @@ function categorize(
   return "extra";
 }
 
-/** Parse alle top-level frontmatter-keys (naam + waarde-indicator niet nodig). */
+/** Parse all top-level frontmatter keys (name only; value is unused). */
 function parseFrontmatterKeys(content: string): string[] {
   const lines = content.split("\n");
   if (lines[0]?.trim() !== "---") return [];
@@ -275,10 +275,10 @@ export function loadSkillCatalog(cwd: string = process.cwd()): SkillEntry[] {
       lineCount = content.split("\n").length;
       mtimeMs = statSync(s.filePath).mtimeMs;
     } catch {
-      warning = "bestand niet leesbaar";
+      warning = "file not readable";
     }
     if (!warning && !s.description.trim()) {
-      warning = "geen description — model ziet deze skill niet in de prompt";
+      warning = "no description — the model will not see this skill in the prompt";
     }
     if (!warning && s.filePath && diagByPath.has(s.filePath)) {
       warning = diagByPath.get(s.filePath);
@@ -299,7 +299,7 @@ export function loadSkillCatalog(cwd: string = process.cwd()): SkillEntry[] {
     };
   });
 
-  // loose entries achteraan; bij naam-collisie wint core
+  // loose entries last; on a name collision core wins
   const looseNames = new Set(loose.map((e) => e.name));
   const catalogPaths = new Set([
     ...entries.map((e) => e.filePath),
@@ -322,7 +322,7 @@ export function loadSkillCatalog(cwd: string = process.cwd()): SkillEntry[] {
   return cachedEntries;
 }
 
-/** Compat: naam → bestandspad (voor inline-invocation). */
+/** Compat: name → file path (for inline-invocation). */
 export function getAvailableSkills(): Map<string, string> {
   loadSkillCatalog();
   return cachedPathMap ?? new Map();
@@ -346,11 +346,11 @@ function loadUsage(): void {
       usageCache.set(name, { count: u.count ?? 0, lastUsed: u.lastUsed ?? 0 });
     }
   } catch {
-    // geen bestand of kapot JSON → lege ledger
+    // missing file or broken JSON → empty ledger
   }
 }
 
-/** Usage voor alle skills (naam → {count, lastUsed}). */
+/** Usage for every skill (name → {count, lastUsed}). */
 export function getSkillUsage(): Map<string, SkillUsage> {
   loadUsage();
   return usageCache;
@@ -359,7 +359,7 @@ export function getSkillUsage(): Map<string, SkillUsage> {
 let usageFlushTimer: ReturnType<typeof setTimeout> | null = null;
 let exitFlushRegistered = false;
 
-/** Schrijf de ledger nu naar schijf (best-effort, sync). */
+/** Write the ledger to disk now (best-effort, sync). */
 export function flushSkillUsage(): void {
   if (usageFlushTimer) {
     clearTimeout(usageFlushTimer);
@@ -371,14 +371,14 @@ export function flushSkillUsage(): void {
     mkdirSync(getAgentDir(), { recursive: true });
     writeFileSync(usageFile(), JSON.stringify(obj, null, 2), "utf8");
   } catch {
-    // best-effort: tracking mag de hot path nooit breken
+    // best-effort: tracking must never break the hot path
   }
 }
 
 /**
- * Log een skill-gebruik. De in-memory ledger wordt meteen bijgewerkt (zodat
- * getSkillUsage() klopt), maar de schijf-write wordt gedebounced zodat de
- * input hot path niet per keystroke een sync writeFileSync doet.
+ * Log a skill use. The in-memory ledger updates immediately (so
+ * getSkillUsage() is correct), but the disk write is debounced so the
+ * input hot path does not do a sync writeFileSync per keystroke.
  */
 export function recordSkillUsage(name: string): void {
   loadUsage();
@@ -436,7 +436,7 @@ export function listSkills(): { name: string; description: string; path: string;
   }));
 }
 
-/** Pure filter/sorteer-logica voor de manager-lijst (testbaar zonder TUI). */
+/** Pure filter/sort for the manager list (testable without a TUI). */
 export function applySkillFilter(
   entries: SkillEntry[],
   query: string,

package/src/extension/ui/overlay-chrome.ts

@@ -84,7 +84,7 @@ function listForQuery(
       ? filtered
       : [
           {
-            label: `geen match voor '${query}'`,
+            label: `no match for '${query}'`,
             value: NONE_VALUE,
           },
         ];