@schlenkr/ragents 0.1.9 → 0.1.11

package/plugins/ragents.reference/run-scripts/word-game/tests/program.test.ts

@@ -7,7 +7,7 @@ import { participants, type WordGameState } from "../src/state.ts";
 
 const message = (content: string): ActorInput => ({ id: "input", content, artifactIds: [], sourceEventIds: [], subscriptionId: null, event: null });
 const firstInput = message(JSON.stringify({ input: null, options: {} }));
-const words = ["Strand", "Sand", "Wüste", "Kamel", "Oase", "Wasser", "Fluss", "Brücke", "Stadt", "Haus", "Garten", "Blume"];
+const words = ["Beach", "Sand", "Desert", "Camel", "Oasis", "Water", "River", "Bridge", "City", "House", "Garden", "Flower"];
 type History = CapabilityContracts["event_query"]["output"];
 
 function fixture(initialState: WordGameState = {}) {
@@ -33,7 +33,7 @@ function fixture(initialState: WordGameState = {}) {
       },
       actor_input: async (input) => {
         calls.push({ name: "actor_input", input });
-        if (settings.failDispatch) throw new Error("Übergabe fehlgeschlagen");
+        if (settings.failDispatch) throw new Error("Handover failed");
         return [{ type: "actor.input.enqueued", payload: { actorId: input.actor, inputId: `request-${calls.length}` } }];
       },
       event_query: async (input) => { calls.push({ name: "event_query", input }); return history.filter((event) => input.actorIds?.includes(event.actorId)); },
@@ -48,9 +48,9 @@ function fixture(initialState: WordGameState = {}) {
     const envelope = { actorId, causationId: null, commandId: "test", correlationId: null, occurredAt: "2026-09-13T12:00:00Z", runId: "test", schemaVersion: 3 as const };
     history.push({ ...envelope, eventId: `${turnId}-start`, sequence: history.length + 1, type: "turn.started", payload: { turnId, inputId: options.inputId ?? state.pendingInputId } });
     history.push({ ...envelope, eventId: `${turnId}-output`, sequence: history.length + 1, type: "model.output.completed", payload: { turnId, text: word } });
-    return { ...message("Ereignis"), subscriptionId: options.subscriptionId ?? "subscription", sourceEventIds: [`${turnId}-finished`],
+    return { ...message("Event"), subscriptionId: options.subscriptionId ?? "subscription", sourceEventIds: [`${turnId}-finished`],
       event: { type: options.type ?? "turn.finished", eventId: `${turnId}-finished`, sequence: history.length + 1, occurredAt: envelope.occurredAt,
-        sourceActorId: actorId, sourceActorHandle: null, payload: { turnId, outcome: options.outcome ?? "completed", reason: "Testunterbrechung" } } };
+        sourceActorId: actorId, sourceActorHandle: null, payload: { turnId, outcome: options.outcome ?? "completed", reason: "Test interruption" } } };
   };
   const start = async () => {
     await program.onInput(firstInput, context);
@@ -60,7 +60,7 @@ function fixture(initialState: WordGameState = {}) {
   return { context, calls, history, settings, response, start };
 }
 
-test("richtet vier reine LLMs und die eigene View ohne Modellauftrag ein", async () => {
+test("sets up four plain LLMs and its own view without a model task", async () => {
   const { context, calls } = fixture();
   await program.onInput(firstInput, context);
   assert.equal(context.state.read().status, "ready");
@@ -69,15 +69,15 @@ test("richtet vier reine LLMs und die eigene View ohne Modellauftrag ein", async
     return { handle: input.handle, name: input.displayName, tools: input.tools, profile: input.profile };
   }), participants.map((participant) => ({ ...participant, tools: [], profile: "standard" })));
   assert.equal(calls.some((call) => call.name === "actor_input"), false);
-  assert.deepEqual(calls.find((call) => call.name === "run_configure")!.input, { title: "Wortspiel", primaryActor: "test-actor" });
+  assert.deepEqual(calls.find((call) => call.name === "run_configure")!.input, { title: "Word game", primaryActor: "test-actor" });
   const before = structuredClone(context.state.read());
   const callCount = calls.length;
-  await assert.rejects(async () => program.onInput(firstInput, context), /keine freien Chatnachrichten/);
+  await assert.rejects(async () => program.onInput(firstInput, context), /does not understand free chat messages/);
   assert.deepEqual(context.state.read(), before);
   assert.equal(calls.length, callCount);
 });
 
-test("der App-Aufruf schickt nur einen Auftrag an den eigenen Steueractor", async () => {
+test("the app call sends only one task to its own control actor", async () => {
   const { context, calls } = fixture();
   await program.onInput(firstInput, context);
   assert.deepEqual(await program.functions.start({}, context), { accepted: true });
@@ -86,7 +86,7 @@ test("der App-Aufruf schickt nur einen Auftrag an den eigenen Steueractor", asyn
   assert.equal(context.state.read().status, "ready");
 });
 
-test("wartet auf spätere Ereignisse, zählt zwölf Beiträge und beendet die Weitergabe", async () => {
+test("waits for later events, counts twelve contributions, and ends the handover", async () => {
   const { context, calls, response, start } = fixture();
   await start();
   assert.deepEqual(calls.slice(-2).map((call) => call.name), ["event_subscribe", "actor_input"]);
@@ -96,17 +96,17 @@ test("wartet auf spätere Ereignisse, zählt zwölf Beiträge und beendet die We
   assert.deepEqual(inputs.map((call) => (call.input as { actor: string }).actor), words.map((_word, index) => `actor-${participants[index % 4]!.handle}`));
   assert.equal(context.state.read().status, "completed");
   assert.equal(context.state.read().entries?.length, 12);
-  assert.match(context.state.read().document!, /12\. Green: Blume/);
+  assert.match(context.state.read().document!, /12\. Green: Flower/);
   assert.equal(context.state.read().pendingInputId, undefined);
   assert.deepEqual(await program.functions.start({}, context), { accepted: false });
 });
 
-test("ignoriert falsche Quellen, fremde Aufträge, falsche Abos und doppelte Ereignisse", async () => {
+test("ignores wrong sources, foreign tasks, wrong subscriptions, and duplicate events", async () => {
   const { context, calls, response, start } = fixture();
   await start();
-  await program.onInput(response("Fremd", { actorId: "actor-blue" }), context);
-  await program.onInput(response("Fremd", { inputId: "foreign-input" }), context);
-  await program.onInput(response("Fremd", { subscriptionId: "foreign-subscription" }), context);
+  await program.onInput(response("Foreign", { actorId: "actor-blue" }), context);
+  await program.onInput(response("Foreign", { inputId: "foreign-input" }), context);
+  await program.onInput(response("Foreign", { subscriptionId: "foreign-subscription" }), context);
   assert.equal(context.state.read().entries?.length, 0);
   const first = response(words[0]!);
   await program.onInput(first, context);
@@ -119,12 +119,12 @@ test("ignoriert falsche Quellen, fremde Aufträge, falsche Abos und doppelte Ere
 });
 
 for (const scenario of [
-  { name: "Modellfehler", word: "Strand", options: { outcome: "failed" } },
-  { name: "Unterbrechung", word: "Strand", options: { type: "turn.interrupted" } },
-  { name: "Mehrwortantwort", word: "Schöner Strand", options: {} },
-  { name: "wiederholtes Ausgangswort", word: "sun", options: {} },
+  { name: "model error", word: "Beach", options: { outcome: "failed" } },
+  { name: "interruption", word: "Beach", options: { type: "turn.interrupted" } },
+  { name: "multi-word answer", word: "Beautiful beach", options: {} },
+  { name: "repeated starting word", word: "sun", options: {} },
 ]) {
-  test(`${scenario.name} bleibt als Fehler sichtbar und startet nicht erneut`, async () => {
+  test(`${scenario.name} stays visible as an error and does not start again`, async () => {
     const { context, calls, response, start } = fixture();
     await start();
     await program.onInput(response(scenario.word, scenario.options), context);
@@ -138,7 +138,7 @@ for (const scenario of [
   });
 }
 
-test("ein weiterer Start während des Spiels verändert keinen Auftrag oder Fortschritt", async () => {
+test("another start during the game changes no task or progress", async () => {
   const { context, calls, start } = fixture();
   await start();
   const before = calls.length;
@@ -148,7 +148,7 @@ test("ein weiterer Start während des Spiels verändert keinen Auftrag oder Fort
 });
 
 for (const status of ["ready", "running", "completed"]) {
-  test(`freie Chatnachrichten werden bei ${status} abgelehnt und erhalten den Spielstand`, async () => {
+  test(`free chat messages are rejected when ${status} and keep the game state`, async () => {
     const { context, calls, response } = fixture();
     await program.onInput(firstInput, context);
     if (status !== "ready") {
@@ -159,8 +159,8 @@ for (const status of ["ready", "running", "completed"]) {
     assert.equal(context.state.read().status, status);
     const before = structuredClone(context.state.read());
     const callCount = calls.length;
-    const content = "Starte das Wortspiel bitte noch einmal von vorn.";
-    await assert.rejects(async () => program.onInput(message(content), context), /keine freien Chatnachrichten.*Startknopf.*neuer Run/);
+    const content = "Please start the word game again from the beginning.";
+    await assert.rejects(async () => program.onInput(message(content), context), /does not understand free chat messages.*start button.*new run/);
     assert.deepEqual(context.state.read(), before);
     assert.equal(calls.length, callCount);
     if (status === "ready") {
@@ -174,32 +174,32 @@ for (const status of ["ready", "running", "completed"]) {
   });
 }
 
-test("eine fehlgeschlagene Übergabe erhält das bereits angenommene Wort", async () => {
+test("a failed handover keeps the word already accepted", async () => {
   const { context, settings, response, start } = fixture();
   await start();
   settings.failDispatch = true;
-  await program.onInput(response("Strand"), context);
+  await program.onInput(response("Beach"), context);
   assert.equal(context.state.read().status, "error");
-  assert.deepEqual(context.state.read().entries, [{ participant: 0, word: "Strand" }]);
-  assert.match(context.state.read().error!, /Übergabe/);
+  assert.deepEqual(context.state.read().entries, [{ participant: 0, word: "Beach" }]);
+  assert.match(context.state.read().error!, /Handover/);
 });
 
-test("fehlendes Standardprofil zeigt einen Fehler ohne Teilnehmer anzulegen", async () => {
+test("a missing standard profile shows an error without creating participants", async () => {
   const { context, settings, calls } = fixture();
   settings.missingProfile = true;
   await program.onInput(firstInput, context);
   assert.equal(context.state.read().status, "error");
-  assert.match(context.state.read().error!, /Rolle standard fehlt/);
+  assert.match(context.state.read().error!, /role standard is missing/);
   assert.deepEqual(calls.map((call) => call.name), ["run_configure", "canvas_layout_replace", "model_list"]);
 });
 
-test("ein wiederhergestellter Zustand zählt den wartenden Auftrag weiter und baut nichts neu", async () => {
+test("a restored state keeps counting the pending task and rebuilds nothing", async () => {
   const previous = fixture();
   await previous.start();
   await program.onInput(previous.response(words[0]!), previous.context);
   const restored = fixture(previous.context.state.read());
   const before = structuredClone(restored.context.state.read());
-  await assert.rejects(async () => program.onInput(firstInput, restored.context), /keine freien Chatnachrichten/);
+  await assert.rejects(async () => program.onInput(firstInput, restored.context), /does not understand free chat messages/);
   assert.deepEqual(restored.context.state.read(), before);
   assert.equal(restored.calls.length, 0);
   await program.onInput(restored.response(words[1]!), restored.context);
@@ -208,11 +208,11 @@ test("ein wiederhergestellter Zustand zählt den wartenden Auftrag weiter und ba
   assert.equal(restored.calls.some((call) => call.name === "agent_spawn"), false);
 });
 
-test("fehlende oder mehrfache Modellausgaben werden nicht als Wort übernommen", async () => {
+test("missing or multiple model outputs are not taken as a word", async () => {
   for (const count of [0, 2]) {
     const { context, history, response, start } = fixture();
     await start();
-    const input = response("Strand");
+    const input = response("Beach");
     const output = history.pop()!;
     for (let index = 0; index < count; index++) history.push({ ...output, eventId: `output-${index}` });
     await program.onInput(input, context);
@@ -221,8 +221,8 @@ test("fehlende oder mehrfache Modellausgaben werden nicht als Wort übernommen",
   }
 });
 
-test("ungültige Startdaten bleiben als Fehler sichtbar und starten kein Modell", async () => {
-  for (const content of ["kein JSON", JSON.stringify({ input: "Strand", options: {} }), JSON.stringify({ input: null, options: [] })]) {
+test("invalid start data stays visible as an error and starts no model", async () => {
+  for (const content of ["no JSON", JSON.stringify({ input: "Beach", options: {} }), JSON.stringify({ input: null, options: [] })]) {
     const { context, calls } = fixture();
     await program.onInput(message(content), context);
     assert.equal(context.state.read().status, "error");
@@ -230,7 +230,7 @@ test("ungültige Startdaten bleiben als Fehler sichtbar und starten kein Modell"
   }
 });
 
-test("akzeptiert die Startoptionen des Profils ohne eigene Modellvorgaben daraus abzuleiten", async () => {
+test("accepts the profile start options without deriving its own model settings from them", async () => {
   const { context, calls } = fixture();
   await program.onInput(message(JSON.stringify({ input: null, options: {
     "ragents.model": { model: "test-model", thinking: "off" },
@@ -242,11 +242,11 @@ test("akzeptiert die Startoptionen des Profils ohne eigene Modellvorgaben daraus
   assert.equal(calls.some((call) => call.name === "actor_input"), false);
 });
 
-test("ein gestoppter aktueller Teilnehmer hält das Spiel an", async () => {
+test("a stopped current participant halts the game", async () => {
   const { context, response, start } = fixture();
   await start();
-  await program.onInput(response("Strand", { type: "actor.stopped" }), context);
+  await program.onInput(response("Beach", { type: "actor.stopped" }), context);
   assert.equal(context.state.read().status, "error");
-  assert.match(context.state.read().error!, /Red wurde gestoppt/);
+  assert.match(context.state.read().error!, /Red was stopped/);
   assert.equal(context.state.read().entries?.length, 0);
 });

package/plugins/ragents.reference/skills/100-shared-actor-list/SKILL.md

@@ -2,11 +2,11 @@
 name: 100-shared-actor-list
 start: true
 disable-model-invocation: true
-title: "Eine Liste im Chat und im Fenster pflegen"
-description: "Zeigt beim Aufbau einer Mini-App, wie Oberfläche und Koordinator dieselbe Funktion eines TypeScript-Actors benutzen und dieselbe Liste ändern."
-category: "Mini-Apps"
+title: "Maintain a list in the chat and in a window"
+description: "Shows, while building a mini-app, how the interface and the coordinator use the same function of a TypeScript actor and change the same list."
+category: "Mini-apps"
 order: 100
-tags: "Anwendungsfall, Konzeptdemo, TypeScript-Actors, Actor-Funktionen, Actor-Zustand, Mini-Apps"
+tags: "Use case, Concept demo, TypeScript actors, Actor functions, Actor state, Mini-apps"
 ---
 
-Ich hätte gern eine gemeinsame Liste an einem TypeScript-Actor ohne KI-Listenhelfer. Ich ergänze Einträge über seine Oberfläche, Du über dieselbe Funktion als Werkzeug. Beide Wege zeigen sofort denselben Stand, auch bei ruhendem Chat. Füge wirklich einen Eintrag hinzu und lass die Oberfläche stehen. Nutze gemeinsame Layout- und Formularbausteine: mehrzeilige Eingabe und Liste nebeneinander, bei wenig Platz untereinander.
+I would like a shared list on a TypeScript actor without an AI list helper. I add entries through its interface, you through the same function as a tool. Both ways immediately show the same state, even when the chat is idle. Actually add an entry and leave the interface in place. Use shared layout and form building blocks: multi-line input and list side by side, stacked when space is tight.

package/plugins/ragents.reference/skills/110-all-card-slots/SKILL.md

@@ -2,11 +2,11 @@
 name: 110-all-card-slots
 start: true
 disable-model-invocation: true
-title: "Rückfrage, Aufgaben und Dokument zusammen sehen"
-description: "Zeigt, wie Aufgabenstand, Dokument und eine offene Rückfrage gleichzeitig an einer Agentenkarte sichtbar bleiben."
-category: "Zusammenarbeit"
+title: "See question, tasks, and document together"
+description: "Shows how task progress, a document, and an open question stay visible on an agent card at the same time."
+category: "Collaboration"
 order: 110
-tags: "Rückfragen, To-dos, Konzeptdemo"
+tags: "Questions, To-dos, Concept demo"
 ---
 
-Ich hätte gern eine KI, die mir drei Aufgaben notiert - eine erledigte, eine in Arbeit und eine offene -, dazu ein kurzes Dokument schreibt und mich zum Schluss fragt, ob sie den offenen Punkt als Nächstes angehen soll. Antworte diese Frage nicht für mich, sondern halt dort an, damit ich Aufgabenliste, Dokument und Frage zusammen sehe und selbst antworten kann.
+I would like an AI that notes three tasks for me - one done, one in progress, and one open -, also writes a short document, and finally asks me whether it should tackle the open item next. Do not answer this question for me; stop there so that I can see the task list, document, and question together and answer myself.

package/plugins/ragents.reference/skills/150-editorial-workbench/SKILL.md

@@ -2,11 +2,11 @@
 name: 150-editorial-workbench
 start: true
 disable-model-invocation: true
-title: "Redaktionswerkstatt"
-description: "Zeigt, wie eine Mini-App Textbearbeitung, einzeln übernehmbare Änderungen und ein Bearbeitungsprotokoll zu einer Redaktionswerkstatt verbindet."
-category: "Mini-Apps"
+title: "Editorial workbench"
+description: "Shows how a mini-app combines text editing, individually acceptable changes, and an edit log into an editorial workbench."
+category: "Mini-apps"
 order: 150
-tags: "Actor-Funktionen, Anwendungsfall, Konzeptdemo, Mini-Apps"
+tags: "Actor functions, Use case, Concept demo, Mini-apps"
 ---
 
-Ich hätte gern eine Redaktionswerkstatt: Reparaturtreff, Samstag 10 bis 14 Uhr, Nachbarschaftshaus, ehrenamtliche Hilfe, keine Garantie. Links wähle ich Original oder Kurzfassung, rechts ändere ich Text und Zielgruppe und übernehme Kürzungen einzeln. Zeige Änderungen und Aufgabenstand, vergleiche Wortzahl und Freigabe tabellarisch. Ein Helfer zählt die Wörter; ein Protokoll zeigt Absender, Übernahmen und Rücknahmen. Veröffentliche nichts.
+I would like an editorial workbench: repair cafe, Saturday 10 am to 2 pm, community center, volunteer help, no guarantee. On the left I choose original or short version, on the right I change text and target audience and accept cuts one by one. Show changes and task progress, compare word count and approval in a table. A helper counts the words; a log shows sender, acceptances, and reversals. Publish nothing.

package/plugins/ragents.reference/skills/160-learning-companion/SKILL.md

@@ -2,11 +2,11 @@
 name: 160-learning-companion
 start: true
 disable-model-invocation: true
-title: "Lernbegleitung mit Unterlagen"
-description: "Zeigt eine eigene Mini-App eines KI-Tutors mit eingebettetem Actor-Chat. Lokal gewählte Unterlagen gelangen erst nach einer ausdrücklichen Aktion ins Gespräch."
-category: "Mini-Apps"
+title: "Learning companion with materials"
+description: "Shows a mini-app of an AI tutor with an embedded actor chat. Locally chosen materials enter the conversation only after an explicit action."
+category: "Mini-apps"
 order: 160
-tags: "Anwendungsfall, Konzeptdemo, Agententeams, Mini-Apps, LLM-Actor mit View, Actor-Chat"
+tags: "Use case, Concept demo, Agent teams, Mini-apps, LLM actor with view, Actor chat"
 ---
 
-Ich hätte gern einen KI-Tutor mit eigener Oberfläche auf der Fläche: Textunterlagen öffnen und lesen, daneben mit genau diesem Tutor sprechen. Ich möchte zwischen Erklären, Beispiel und Verständnisprüfung wählen. Die ausgewählte Datei soll erst nach meinem Klick im Gespräch verwendet werden. Fragen ohne Datei sollen auch gehen. Nutze die vorhandenen Chat-, Datei- und Auswahlbausteine.
+I would like an AI tutor with its own interface on the surface: open and read text materials, and talk to exactly this tutor next to them. I want to choose between explanation, example, and comprehension check. The selected file should be used in the conversation only after my click. Questions without a file should work too. Use the existing chat, file, and selection building blocks.

package/plugins/ragents.reference/skills/170-photo-collection/SKILL.md

@@ -2,11 +2,11 @@
 name: 170-photo-collection
 start: true
 disable-model-invocation: true
-title: "Bildsammlung mit Beschriftungen"
-description: "Zeigt eine eigene Mini-App eines KI-Schreibhelfers mit Bildvorschauen, bearbeitbaren Beschriftungen und direktem Chat. Die Auswahl lokaler Bilder sendet sie noch nicht an die KI."
-category: "Mini-Apps"
+title: "Image collection with captions"
+description: "Shows a mini-app of an AI writing helper with image previews, editable captions, and a direct chat. Selecting local images does not send them to the AI yet."
+category: "Mini-apps"
 order: 170
-tags: "Anwendungsfall, Konzeptdemo, Agententeams, Mini-Apps, LLM-Actor mit View, Actor-Chat"
+tags: "Use case, Concept demo, Agent teams, Mini-apps, LLM actor with view, Actor chat"
 ---
 
-Ich hätte gern einen KI-Schreibhelfer mit eigener Oberfläche für eine kleine Bildsammlung: Bilder hineinziehen, Vorschauen sehen, die Liste durchsuchen und pro Bild Titel, Bildunterschrift und Alternativtext bearbeiten. Daneben möchte ich einen Chat mit genau diesem Schreibhelfer und eine lesbare Übersicht aller Beschriftungen. Meine Bilder bleiben lokal, bis ich selbst etwas im Chat sende. Nutze die vorhandenen Bausteine.
+I would like an AI writing helper with its own interface for a small image collection: drag images in, see previews, search the list, and edit title, caption, and alt text for each image. Next to it I want a chat with exactly this writing helper and a readable overview of all captions. My images stay local until I send something in the chat myself. Use the existing building blocks.

package/plugins/ragents.reference/skills/180-decision-workbench/SKILL.md

@@ -2,11 +2,11 @@
 name: 180-decision-workbench
 start: true
 disable-model-invocation: true
-title: "Entscheidungswerkstatt"
-description: "Zeigt ein fest geführtes Gespräch ohne KI-Aufrufe. Ein TypeScript-Actor hält Antworten und Fortschritt; Änderungen am Entscheidungsentwurf werden sichtbar."
-category: "Mini-Apps"
+title: "Decision workbench"
+description: "Shows a strictly guided conversation without AI calls. A TypeScript actor keeps answers and progress; changes to the decision draft become visible."
+category: "Mini-apps"
 order: 180
-tags: "Anwendungsfall, Konzeptdemo, TypeScript-Actors, Actor-Zustand, Mini-Apps, Frei gesteuerter Chat"
+tags: "Use case, Concept demo, TypeScript actors, Actor state, Mini-apps, Controlled chat"
 ---
 
-Ich hätte gern eine lokale Entscheidungshilfe: Bibliothek oder Café als Lernort? Feste Fragen führen durch Ziel, Optionen und Kriterien, protokollieren meine Entscheidung und zeigen den Fortschritt. Bei einer Meinungsänderung will ich den Unterschied zum vorherigen Entwurf sehen. Ein TypeScript-Actor führt den gemeinsamen Fortschritt und die Antworten. Das soll eine klar erkennbare Anleitung ohne KI-Aufrufe sein, mit den vorhandenen Chatbausteinen.
+I would like a local decision aid: library or cafe as a place to study? Fixed questions guide me through goal, options, and criteria, record my decision, and show the progress. If I change my mind, I want to see the difference from the previous draft. A TypeScript actor keeps the shared progress and the answers. This should be a clearly recognizable guide without AI calls, using the existing chat building blocks.

package/plugins/ragents.reference/skills/190-review-queue/SKILL.md

@@ -2,11 +2,11 @@
 name: 190-review-queue
 start: true
 disable-model-invocation: true
-title: "Texte prüfen und Ergebnisse gezielt teilen"
-description: "Zeigt an drei Textprüfungen die Input-Warteschlange, gezielte Ergebnisfreigaben und den Actor-Stopp. Die Mini-App sammelt ungeschützte Statusmeldungen."
-category: "Mini-Apps"
+title: "Review texts and share results selectively"
+description: "Shows the input queue, selective result sharing, and stopping an actor using three text reviews. The mini-app collects unprotected status messages."
+category: "Mini-apps"
 order: 190
-tags: "Journalprüfung, Anwendungsfall, Konzeptdemo, Agententeams, Input-Warteschlange, Actor-Stopp, Artefakte und Zugriff, Mini-Apps"
+tags: "Journal inspection, Use case, Concept demo, Agent teams, Input queue, Stopping actors, Artifacts and access, Mini-apps"
 ---
 
-Ich hätte gern drei getrennte Textprüfungen zum Nachbarschaftsfest, die ich während der ersten Prüfung einreihe. Nur der bestimmte Empfänger darf das erste Ergebnis lesen; prüfe auch einen Zugriff ohne Freigabe. Danach meldest du den Prüfer ab. Belege Reihenfolge, Zugriff und Stopp. Eine Oberfläche des vorhandenen Koordinators zeigt auf der Fläche nur ungeschützte Statusmeldungen verschiedener Absender. Eine eigene Notiz möchte ich ergänzen können.
+I would like three separate text reviews for the neighborhood party, which I queue during the first review. Only the designated recipient may read the first result; also test an access without sharing. After that, you sign the reviewer off. Prove order, access, and stop. An interface of the existing coordinator shows only unprotected status messages from various senders on the surface. I want to be able to add a note of my own.

package/plugins/ragents.reference/skills/20-circle-of-four/SKILL.md

@@ -2,11 +2,11 @@
 name: 20-circle-of-four
 start: true
 disable-model-invocation: true
-title: "Eine Liste durch vier KI-Helfer reichen"
-description: "Zeigt beim Aufbau eines Wortspiels, wie vier KI-Helfer nacheinander beitragen und ein TypeScript-Actor die Weitergabe nach zwölf Wörtern beendet."
-category: "Zusammenarbeit"
+title: "Pass a list through four AI helpers"
+description: "Shows, while building a word game, how four AI helpers contribute one after another and a TypeScript actor ends the handover after twelve words."
+category: "Collaboration"
 order: 20
-tags: "Anwendungsfall, Konzeptdemo, Agententeams, TypeScript-Actors, Subscriptions"
+tags: "Use case, Concept demo, Agent teams, TypeScript actors, Subscriptions"
 ---
 
-Ich hätte gern vier KIs mit den Namen rot, gelb, blau und grün, die reihum ein Wortspiel spielen: jede hängt ein Wort an, das ihr zum zuletzt genannten einfällt. Nach zwölf Beiträgen ist Schluss, und ich will die fertige Liste als Dokument sehen.
+I would like four AIs named red, yellow, blue, and green that play a word game in rotation: each one appends a word that comes to mind for the last one named. After twelve contributions it is over, and I want to see the finished list as a document.

package/plugins/ragents.reference/skills/200-typescript-diagnostics/SKILL.md

@@ -2,11 +2,11 @@
 name: 200-typescript-diagnostics
 start: true
 disable-model-invocation: true
-title: "Fehler in einer Terminliste finden"
-description: "Zeigt an einer TypeScript-Terminliste, wie sich echte Sprachdiagnosen nach jeder einzelnen Korrektur ändern. Das korrigierte Beispiel bleibt zum Nachlesen erhalten."
-category: "Code und Diagnose"
+title: "Find errors in an appointment list"
+description: "Shows on a TypeScript appointment list how real language diagnostics change after each individual correction. The corrected example is kept for reference."
+category: "Code and diagnostics"
 order: 200
-tags: "Anwendungsfall, Konzeptdemo, Sprachprüfung"
+tags: "Use case, Concept demo, Language diagnostics"
 ---
 
-Ich hätte gern eine kleine TypeScript-Terminliste mit zwei absichtlichen Typfehlern. Lass die Sprachprüfung beide finden und korrigiere sie einzeln. Nach jeder Korrektur möchte ich den echten Befund sehen. Am Ende bleiben das korrigierte Beispiel und ein kurzer Vergleich zum Nachlesen. Falls die Sprachprüfung fehlt, sag das klar.
+I would like a small TypeScript appointment list with two deliberate type errors. Let the language check find both and correct them one at a time. After each correction I want to see the real finding. At the end, the corrected example and a short comparison remain for reference. If the language check is missing, say so clearly.

package/plugins/ragents.reference/skills/210-moderator-handover/SKILL.md

@@ -2,11 +2,11 @@
 name: 210-moderator-handover
 start: true
 disable-model-invocation: true
-title: "Gespräch an einen Moderator übergeben"
-description: "Zeigt die Übergabe eines laufenden Chats an einen anderen Primary-Actor. Der Moderator übernimmt als direkter Ansprechpartner und hält den Aufgabenfortschritt fest."
-category: "Zusammenarbeit"
+title: "Hand a conversation over to a moderator"
+description: "Shows the handover of a running chat to another primary actor. The moderator takes over as the direct contact and records the task progress."
+category: "Collaboration"
 order: 210
-tags: "Rückfragen, To-dos, Anwendungsfall, Konzeptdemo, Agententeams, Primary-Actor"
+tags: "Questions, To-dos, Use case, Concept demo, Agent teams, Primary actor"
 ---
 
-Ich hätte gern einen Workshop für einen ruhigeren Arbeitstag: Ein Planer bringt zwei Ideen mit, ein skeptischer Gast prüft die Nachteile. Ein Moderator übernimmt die Runde und spricht danach direkt mit mir im Chat, damit ich einen Vorschlag auswählen kann. Zeig die drei auf der Fläche und übergib das Gespräch wirklich an den Moderator. Seine Aufgabenliste zeigt den Fortschritt.
+I would like a workshop for a calmer workday: a planner brings two ideas, a skeptical guest examines the downsides. A moderator takes over the round and then talks directly with me in the chat so that I can pick a proposal. Show the three on the surface and actually hand the conversation over to the moderator. Its task list shows the progress.

package/plugins/ragents.reference/skills/220-actor-approval-list/SKILL.md

@@ -2,11 +2,11 @@
 name: 220-actor-approval-list
 start: true
 disable-model-invocation: true
-title: "Vorschläge gemeinsam freigeben"
-description: "Zeigt einen KI-Listenhelfer mit eigener Mini-App und gemeinsamem Zustand. Seine Vorschläge lassen sich per Funktion bestätigen, ohne eine weitere KI-Antwort abzuwarten."
-category: "Mini-Apps"
+title: "Approve proposals together"
+description: "Shows an AI list helper with its own mini-app and shared state. Its proposals can be confirmed through a function without waiting for another AI answer."
+category: "Mini-apps"
 order: 220
-tags: "Anwendungsfall, Konzeptdemo, Agententeams, Actor-Funktionen, Actor-Zustand, Mini-Apps, LLM-Actor mit View, Frei gesteuerter Chat"
+tags: "Use case, Concept demo, Agent teams, Actor functions, Actor state, Mini-apps, LLM actor with view, Controlled chat"
 ---
 
-Ich hätte gern einen KI-Listenhelfer mit eigener Oberfläche. Dort prüfe und bestätige ich seine Vorschläge; bestätigte Einträge stehen daneben. Der Helfer benutzt dieselben Funktionen und dieselbe Liste, wenn ich ihn im Chat um einen Eintrag bitte. Lass ihn einen echten Vorschlag machen. Die Freigabe per Knopf soll ohne weitere KI-Antwort seinen gespeicherten Vorschlag bestätigen. Danach möchte ich selbst einen eingeben.
+I would like an AI list helper with its own interface. There I review and confirm its proposals; confirmed entries are shown next to them. The helper uses the same functions and the same list when I ask it for an entry in the chat. Have it make a real proposal. Approval by button should confirm its saved proposal without another AI answer. After that I want to enter one myself.

package/plugins/ragents.reference/skills/230-shared-state-views/SKILL.md

@@ -2,11 +2,11 @@
 name: 230-shared-state-views
 start: true
 disable-model-invocation: true
-title: "Eine Liste in zwei Ansichten"
-description: "Zeigt zwei Mini-App-Ansichten desselben Actor-Zustands. Änderungen erscheinen in beiden; eine Ansicht lässt sich unabhängig ausblenden."
-category: "Mini-Apps"
+title: "One list in two views"
+description: "Shows two mini-app views of the same actor state. Changes appear in both; one view can be hidden independently."
+category: "Mini-apps"
 order: 230
-tags: "Anwendungsfall, Konzeptdemo, Actor-Funktionen, Actor-Zustand, Mini-Apps"
+tags: "Use case, Concept demo, Actor functions, Actor state, Mini-apps"
 ---
 
-Ich hätte gern eine Aufgabenliste mit zwei kleinen Fenstern: In einem ergänze und erledige ich Aufgaben, im anderen sehe ich nur offene und erledigte Anzahlen. Beide gehören zum selben Helfer und benutzen dieselben Daten. Ergänze wirklich eine Aufgabe und erledige sie. Beide Fenster sollen sofort mitziehen. Danach blende nur die Zusammenfassung aus und wieder ein; meine Liste bleibt erhalten.
+I would like a task list with two small windows: in one I add and complete tasks, in the other I only see the open and completed counts. Both belong to the same helper and use the same data. Actually add a task and complete it. Both windows should update immediately. Then hide only the summary and show it again; my list is kept.

package/plugins/ragents.reference/skills/240-live-result-list/SKILL.md

@@ -2,11 +2,11 @@
 name: 240-live-result-list
 start: true
 disable-model-invocation: true
-title: "Antworten automatisch sammeln"
-description: "Zeigt, wie ein TypeScript-Actor fertige Agentenantworten per Abonnement automatisch sammelt. Auch weitere Beiträge desselben Helfers lassen die Liste wachsen."
-category: "Mini-Apps"
+title: "Collect answers automatically"
+description: "Shows how a TypeScript actor automatically collects finished agent answers through a subscription. Further contributions from the same helper also make the list grow."
+category: "Mini-apps"
 order: 240
-tags: "Anwendungsfall, Konzeptdemo, TypeScript-Actors, Subscriptions, Actor-Zustand, Mini-Apps"
+tags: "Use case, Concept demo, TypeScript actors, Subscriptions, Actor state, Mini-apps"
 ---
 
-Ich hätte gern zwei KI-Helfer, die je eine kurze Idee für einen gemeinsamen Lernnachmittag vorschlagen. Ihre fertigen Antworten sollen automatisch in einer kleinen Ergebnisliste auf der Fläche erscheinen. Ein programmierter Sammler merkt sich die Beiträge; dafür soll keine weitere KI die Texte kopieren. Lass danach einen Helfer eine zweite Idee ergänzen. Die Liste soll von selbst wachsen, auch wenn Du im Chat gerade nichts schreibst.
+I would like two AI helpers that each suggest a short idea for a shared learning afternoon. Their finished answers should automatically appear in a small result list on the surface. A programmed collector remembers the contributions; no further AI should copy the texts for this. Then have one helper add a second idea. The list should grow by itself, even while you are not writing anything in the chat.

package/plugins/ragents.reference/skills/250-balcony-wizard/SKILL.md

@@ -2,11 +2,11 @@
 name: 250-balcony-wizard
 start: true
 disable-model-invocation: true
-title: "Balkon-Wizard"
-description: "Zeigt den Aufbau einer eigenständigen Mini-App für ein adaptives KI-Interview. Das LLM wählt die Fragen, das Formular begrenzt das Gespräch auf fünf Antworten."
-category: "Mini-Apps"
+title: "Balcony wizard"
+description: "Shows how to build a standalone mini-app for an adaptive AI interview. The LLM chooses the questions, the form limits the conversation to five answers."
+category: "Mini-apps"
 order: 250
-tags: "Anwendungsfall, Konzeptdemo, Mini-Apps, Actor-Funktionen, Actor-Zustand"
+tags: "Use case, Concept demo, Mini-apps, Actor functions, Actor state"
 ---
 
-Ich hätte gern einen Balkon-Wizard als eigenständige App auf der Fläche. Sie vermittelt ein begrenztes Gespräch mit einem KI-Berater im Hintergrund. Nach jeder Antwort wählt das LLM die nächste passende Frage, keine feste Fragenliste. Nach fünf Antworten gibt es Gestaltungstipps. Ich antworte nur in der App; sie zeigt Frage, Fortschritt, Lade- und Fehlerzustände. Nutze gemeinsame Layouts und Formulare. Keine App in einer LLM-Chatkarte.
+I would like a balcony wizard as a standalone app on the surface. It mediates a limited conversation with an AI advisor in the background. After each answer, the LLM chooses the next fitting question, no fixed list of questions. After five answers there are design tips. I answer only in the app; it shows question, progress, loading, and error states. Use shared layouts and forms. No app in an LLM chat card.

package/plugins/ragents.reference/skills/30-llm-without-runtime-knowledge/SKILL.md

@@ -2,11 +2,11 @@
 name: 30-llm-without-runtime-knowledge
 start: true
 disable-model-invocation: true
-title: "Eine Nachricht überbringen lassen"
-description: "Zeigt eine einseitige Weiterleitung zwischen zwei KI-Helfern, die den Ablauf und den anderen Teilnehmer nicht kennen."
-category: "Zusammenarbeit"
+title: "Have a message delivered"
+description: "Shows a one-way forwarding between two AI helpers that know neither the flow nor the other participant."
+category: "Collaboration"
 order: 30
-tags: "Konzeptdemo, Agententeams, Subscriptions, Actor-Stopp"
+tags: "Concept demo, Agent teams, Subscriptions, Stopping actors"
 ---
 
-Ich hätte gern zwei KIs, anna und ben, die sich genau einmal freundlich begrüßen, ohne voneinander oder von der Technik dahinter zu wissen: anna sagt einen herzlichen Satz, ben antwortet einmal darauf, danach ist Schluss. Sag mir hinterher kurz, dass wirklich nur in diese eine Richtung weitergereicht wurde und danach alles wieder aufgeräumt ist.
+I would like two AIs, anna and ben, that greet each other kindly exactly once without knowing about each other or the technology behind it: anna says a warm sentence, ben replies once, then it is over. Afterwards, briefly tell me that it really was passed on in only this one direction and that everything has been cleaned up again.

package/plugins/ragents.reference/skills/35-actor-input-fifo/SKILL.md

@@ -2,11 +2,11 @@
 name: 35-actor-input-fifo
 start: true
 disable-model-invocation: true
-title: "Drei Aufträge der Reihe nach erledigen"
-description: "Zeigt, ob während eines laufenden Turns eingereihte Aufträge getrennt und in Eingangsreihenfolge verarbeitet werden. Das Journal liefert die Belege."
-category: "Ereignisse und Abläufe"
+title: "Complete three tasks in order"
+description: "Shows whether tasks queued during a running turn are processed separately and in order of arrival. The journal provides the evidence."
+category: "Events and flows"
 order: 35
-tags: "Journalprüfung, Konzeptdemo, Input-Warteschlange"
+tags: "Journal inspection, Concept demo, Input queue"
 ---
 
-Ich hätte gern einen Helfer, der jeden Text, den ich ihm gebe, mit "ERLEDIGT: " und dem unveränderten Text beantwortet und beim Wort "eins" vorher ausgiebig nachdenkt. Während er noch an "eins" sitzt, schiebe ich ihm "zwei" und "drei" hinterher. Zeig mir danach mit Belegen, dass er alle drei sauber getrennt und genau in dieser Reihenfolge abgearbeitet hat und nichts vermischt wurde.
+I would like a helper that answers every text I give it with "DONE: " and the unchanged text, and thinks extensively beforehand on the word "one". While it is still working on "one", I send it "two" and "three" right after. Afterwards, show me with evidence that it handled all three cleanly separated and in exactly this order and that nothing got mixed up.