@schlenkr/ragents 0.1.10 → 0.1.12

package/plugins/ragents.reference/skills/40-subscription-matrix/SKILL.md

@@ -2,11 +2,11 @@
 name: 40-subscription-matrix
 start: true
 disable-model-invocation: true
-title: "Gezielt bei anderen Helfern mithören"
-description: "Zeigt, wie Abonnements nach Absender und Ereignisart filtern. Eine belegte Empfangstabelle macht passende und ausgeschlossene Ereignisse sichtbar."
-category: "Ereignisse und Abläufe"
+title: "Listen in on other helpers selectively"
+description: "Shows how subscriptions filter by sender and event type. A receipt table with evidence makes matching and excluded events visible."
+category: "Events and flows"
 order: 40
-tags: "Journalprüfung, Konzeptdemo, Subscriptions"
+tags: "Journal inspection, Concept demo, Subscriptions"
 ---
 
-Ich hätte gern drei KIs a, b und c und dazu zwei Zuhörer: der eine soll nur mitbekommen, was a und b sagen, der andere nur, wenn eine der drei tatsächlich etwas ausgeführt hat. Lass danach alle drei etwas sagen und mindestens eine wirklich etwas tun. Gib mir am Ende eine Tabelle, bei welchem Zuhörer was angekommen ist und was nicht, und belege sie.
+I would like three AIs a, b, and c plus two listeners: one should only hear what a and b say, the other only when one of the three has actually executed something. Then have all three say something and at least one actually do something. At the end, give me a table of what arrived at which listener and what did not, and back it up with evidence.

package/plugins/ragents.reference/skills/50-subscription-removal/SKILL.md

@@ -2,11 +2,11 @@
 name: 50-subscription-removal
 start: true
 disable-model-invocation: true
-title: "Eine Weiterleitung wieder abschalten"
-description: "Zeigt die Wirkung eines entfernten Abonnements: Die erste Nachricht kommt an, nach dem Abschalten endet die Weiterleitung."
-category: "Ereignisse und Abläufe"
+title: "Turn a forwarding off again"
+description: "Shows the effect of a removed subscription: The first message arrives, after turning it off the forwarding ends."
+category: "Events and flows"
 order: 50
-tags: "Konzeptdemo, Subscriptions"
+tags: "Concept demo, Subscriptions"
 ---
 
-Ich hätte gern drei KIs: eine Quelle, eine Senke und eine dazwischen, die jedes Wort der Quelle wortgleich an die Senke durchreicht. Lass die Quelle zuerst "eins" sagen, nimm der mittleren danach das Mithören wieder weg und lass die Quelle "zwei" sagen. Erklär mir mit Belegen, was beim zweiten Mal passiert und ob bei der Senke noch etwas ankommt.
+I would like three AIs: a source, a sink, and one in between that passes every word of the source on to the sink verbatim. Have the source say "one" first, then take away the listening from the middle one and have the source say "two". Explain to me with evidence what happens the second time and whether anything still arrives at the sink.

package/plugins/ragents.reference/skills/60-stop-in-the-circle/SKILL.md

@@ -2,11 +2,11 @@
 name: 60-stop-in-the-circle
 start: true
 disable-model-invocation: true
-title: "Einen Helfer in der Gesprächsrunde stoppen"
-description: "Zeigt, wie der Stopp eines Actors eine Übergabekette unterbricht und was nachfolgende Actors noch erhalten."
-category: "Ereignisse und Abläufe"
+title: "Stop a helper in the conversation circle"
+description: "Shows how stopping an actor interrupts a handover chain and what subsequent actors still receive."
+category: "Events and flows"
 order: 60
-tags: "Journalprüfung, Konzeptdemo, Actor-Stopp"
+tags: "Journal inspection, Concept demo, Stopping actors"
 ---
 
-Ich hätte gern vier KIs rot, gelb, blau und grün, die im Kreis eine Liste weiterreichen und jede eine eigene Zeile anhängt. Sobald die Liste einmal ganz herum war, schalte blau ab. Erzähl mir mit Belegen, woran die nächste Runde scheitert und ob grün danach überhaupt noch etwas bekommt.
+I would like four AIs red, yellow, blue, and green that pass a list around in a circle, each appending a line of its own. As soon as the list has gone all the way around once, switch blue off. Tell me with evidence why the next round fails and whether green still gets anything at all afterwards.

package/plugins/ragents.reference/skills/65-artifact-least-privilege/SKILL.md

@@ -2,11 +2,11 @@
 name: 65-artifact-least-privilege
 start: true
 disable-model-invocation: true
-title: "Eine Notiz gezielt weitergeben"
-description: "Zeigt, wie die ausdrückliche Weitergabe einer Notiz den Lesezugriff steuert und ein abgelehnter Zugriff die Freigabe unverändert lässt."
-category: "Dateien und Ergebnisse"
+title: "Pass on a note selectively"
+description: "Shows how explicitly passing on a note controls read access and how a rejected access leaves the sharing unchanged."
+category: "Files and results"
 order: 65
-tags: "Konzeptdemo, Artefakte und Zugriff"
+tags: "Concept demo, Artifacts and access"
 ---
 
-Ich hätte gern drei KIs: die erste schreibt eine kurze geheime Notiz und gibt sie ausdrücklich an die zweite weiter, die dritte erfährt nur, dass es die Notiz gibt. Prüf für mich, wer sie wirklich lesen kann und wer nicht, und ob der abgelehnte Versuch daran etwas ändert. Den Inhalt der Notiz schreibst Du mir dabei nicht noch einmal hin.
+I would like three AIs: the first writes a short secret note and explicitly passes it on to the second, the third only learns that the note exists. Check for me who can really read it and who cannot, and whether the rejected attempt changes anything. Do not write the content of the note out for me again.

package/plugins/ragents.reference/skills/70-headless-counter/SKILL.md

@@ -2,11 +2,11 @@
 name: 70-headless-counter
 start: true
 disable-model-invocation: true
-title: "Nachrichten ohne KI mitzählen"
-description: "Zeigt einen dauerhaften TypeScript-Actor ohne Oberfläche: Er verarbeitet Nachrichten getrennt und behält Liste und Zähler zwischen Aufträgen."
-category: "TypeScript ohne Oberfläche"
+title: "Count messages without AI"
+description: "Shows a persistent TypeScript actor without an interface: It processes messages separately and keeps its list and counter between tasks."
+category: "TypeScript without UI"
 order: 70
-tags: "Anwendungsfall, Konzeptdemo, TypeScript-Actors, Actor-Funktionen, Actor-Zustand, Journalprüfung"
+tags: "Use case, Concept demo, TypeScript actors, Actor functions, Actor state, Journal inspection"
 ---
 
-Ich hätte gern einen kleinen TypeScript-Zähler ohne Oberfläche und ohne KI-Aufrufe. Schicke ihm nacheinander die Texte "eins", "zwei" und "drei". Er soll jeden Text in seiner eigenen Liste behalten und mitzählen. Danach lies seinen Stand aus und belege, dass drei getrennte Eingaben verarbeitet wurden. Der Zähler soll für weitere Texte bereitbleiben.
+I would like a small TypeScript counter without an interface and without AI calls. Send it the texts "one", "two", and "three" one after another. It should keep each text in its own list and count along. Then read out its state and prove that three separate inputs were processed. The counter should stay ready for further texts.

package/plugins/ragents.reference/skills/75-lsp-demo/SKILL.md

@@ -2,11 +2,11 @@
 name: 75-lsp-demo
 start: true
 disable-model-invocation: true
-title: "Fehler in C# und TypeScript finden"
-description: "Zeigt echte Sprachdiagnosen in C# und TypeScript und wie die gemeldeten Fehler nach ihrer Korrektur verschwinden."
-category: "Code und Diagnose"
+title: "Find errors in C# and TypeScript"
+description: "Shows real language diagnostics in C# and TypeScript and how the reported errors disappear after they are corrected."
+category: "Code and diagnostics"
 order: 75
-tags: "Konzeptdemo, Sprachprüfung"
+tags: "Concept demo, Language diagnostics"
 ---
 
-Ich hätte gern eine kleine Vorführung der eingebauten Sprachprüfung: Lege zwei winzige Wegwerf-Projekte an, eines in C# und eines in TypeScript, und baue in beide einen absichtlichen Fehler ein. Zeig mir, wie die Sprachprüfung die Fehler findet und was sie genau meldet. Danach behebst Du beide Fehler, zeigst, dass nichts mehr angemeckert wird, und räumst die Projekte wieder weg.
+I would like a small demonstration of the built-in language check: Create two tiny throwaway projects, one in C# and one in TypeScript, and put a deliberate error into each. Show me how the language check finds the errors and what exactly it reports. Then fix both errors, show that nothing is flagged anymore, and clean up the projects again.

package/plugins/ragents.reference/skills/80-actor-text-analysis/SKILL.md

@@ -2,11 +2,11 @@
 name: 80-actor-text-analysis
 start: true
 disable-model-invocation: true
-title: "Zeichen, Wörter und Zeilen zählen"
-description: "Zeigt, wie Chat und Mini-App dieselbe TypeScript-Funktion und denselben Aufrufzähler nutzen. Ausblenden erhält den Actor-Zustand."
-category: "Mini-Apps"
+title: "Count characters, words, and lines"
+description: "Shows how the chat and a mini-app use the same TypeScript function and the same call counter. Hiding keeps the actor state."
+category: "Mini-apps"
 order: 10
-tags: "Anwendungsfall, Konzeptdemo, TypeScript-Actors, Actor-Funktionen, Actor-Zustand, Mini-Apps, Automatische View-Platzierung, View-Sichtbarkeit"
+tags: "Use case, Concept demo, TypeScript actors, Actor functions, Actor state, Mini-apps, Automatic view placement, View visibility"
 ---
 
-Ich hätte gern eine Textanalyse mit Textfeld, Zählknopf und verständlichen Fehlern. Ein TypeScript-Actor zählt Zeichen, Wörter, Zeilen und seine Aufrufe ohne KI. Prüfe "Die Welt ist groß." und "Und schön." als zwei Zeilen: 6 Wörter. Die Oberfläche zeigt denselben Aufrufzähler. Blende sie aus und wieder ein; der Zustand bleibt. Nutze gemeinsame Layout- und Formularbausteine: Eingabe und Ergebnis nebeneinander, bei wenig Platz untereinander.
+I would like a text analysis with a text field, a count button, and understandable errors. A TypeScript actor counts characters, words, lines, and its calls without AI. Check "The world is big." and "And beautiful." as two lines: 6 words. The interface shows the same call counter. Hide it and show it again; the state is kept. Use shared layout and form building blocks: input and result side by side, stacked when space is tight.

package/plugins/ragents.reference/skills/90-actor-notes/SKILL.md

@@ -2,11 +2,11 @@
 name: 90-actor-notes
 start: true
 disable-model-invocation: true
-title: "Notizen ausblenden und wiederfinden"
-description: "Zeigt eine automatisch platzierte Mini-App mit Notizauswahl. Beim Ausblenden und Wiederanzeigen bleiben Actor und Notizen erhalten."
-category: "Mini-Apps"
+title: "Hide notes and find them again"
+description: "Shows an automatically placed mini-app with note selection. When hiding and showing it again, the actor and notes are kept."
+category: "Mini-apps"
 order: 90
-tags: "Anwendungsfall, Konzeptdemo, TypeScript-Actors, Actor-Funktionen, Actor-Zustand, Mini-Apps, Automatische View-Platzierung, View-Sichtbarkeit"
+tags: "Use case, Concept demo, TypeScript actors, Actor functions, Actor state, Mini-apps, Automatic view placement, View visibility"
 ---
 
-Ich hätte gern einen TypeScript-Actor für meine Notizen. Seine Oberfläche mit Eingabe und Zähler soll von selbst auf der Fläche erscheinen: links eine durchsuchbare Titelliste, rechts die ausgewählte Notiz. Ergänze eine erste Notiz über seine Funktion. Blende die Oberfläche kurz aus und wieder ein, ohne den Actor zu löschen oder Notizen zurückzusetzen. Lass sie zum Eintragen meiner nächsten Idee offen.
+I would like a TypeScript actor for my notes. Its interface with input and counter should appear on the surface by itself: a searchable list of titles on the left, the selected note on the right. Add a first note through its function. Hide the interface briefly and show it again without deleting the actor or resetting notes. Leave it open for entering my next idea.

package/plugins/ragents.reference/skills/95-hello-world/SKILL.md

@@ -2,11 +2,11 @@
 name: 95-hello-world
 start: true
 disable-model-invocation: true
-title: "Hallo Welt auf der Fläche"
-description: "Zeigt den kleinsten Aufbau einer Mini-App am vorhandenen Actor: eine reine Anzeige ohne neuen Actor oder Serverfunktion."
-category: "Mini-Apps"
+title: "Hello world on the surface"
+description: "Shows the smallest setup of a mini-app on the existing actor: a pure display without a new actor or server function."
+category: "Mini-apps"
 order: 5
-tags: "Konzeptdemo, Mini-Apps"
+tags: "Concept demo, Mini-apps"
 ---
 
-Ich hätte gern an Deinem vorhandenen Actor eine kleine Oberfläche auf der Fläche, die einfach nur Hallo Welt sagt. Sie soll sonst nichts tun. Lege dafür keinen neuen Actor und keine Serverfunktion an.
+I would like a small interface on the surface for your existing actor that simply says Hello world. It should do nothing else. Do not create a new actor or a server function for it.

package/plugins/ragents.reference/skills/decision-brief/SKILL.md

@@ -1,33 +1,33 @@
 ---
 start: true
-title: "Entscheidung klären"
-category: "Zusammenarbeit"
-prompt: "Ich hätte gern Hilfe dabei, eine offene Entscheidung zu klären und den nächsten Schritt festzuhalten."
+title: "Clarify a decision"
+category: "Collaboration"
+prompt: "I would like help clarifying an open decision and recording the next step."
 order: 20
-tags: "Anwendungsfall, Konzeptdemo, Skills"
+tags: "Use case, Concept demo, Skills"
 name: decision-brief
-description: "Zeigt, wie eine wiederverwendbare Skill-Anleitung eine Entscheidung im Chat von Kriterien zur Auswahl führt, ohne zusätzliche Actors oder Scripts anzulegen."
+description: "Shows how a reusable skill guide leads a decision in the chat from criteria to a choice without creating additional actors or scripts."
 ---
 
-# Entscheidung klären
+# Clarify a decision
 
-Nutze diesen Ablauf für eine konkrete Alltags- oder Projektentscheidung. Er ist eine
-Arbeitsanweisung für den Koordinator und erstellt keine zusätzlichen Agenten oder Scripts.
+Use this flow for a concrete everyday or project decision. It is a work instruction
+for the coordinator and does not create additional agents or scripts.
 
-1. Frage nach der Entscheidung, den bekannten Alternativen und der wichtigsten Einschränkung.
-   Fehlt noch der Gegenstand, beginne nur mit dieser Frage und beende den Turn bis zur Antwort.
-   Erfinde keine persönlichen Prioritäten. Als freiwilliges Beispiel eignet sich die Frage,
-   ob eine Nachbarschaftsveranstaltung drinnen oder draußen stattfinden soll.
-2. Formuliere die Entscheidung in einem Satz. Schlage höchstens drei überprüfbare Kriterien vor,
-   die zur Antwort passen. Lass den Benutzer fehlende Kriterien ergänzen oder Prioritäten ändern.
-3. Stelle die Alternativen in einer kurzen Tabelle gegenüber. Trenne bekannte Angaben und
-   Annahmen; bewerte unbekannte Kosten oder Eigenschaften nicht als Fakten. Externe Informationen
-   recherchierst du nur mit tatsächlich verfügbaren Werkzeugen und kennzeichnest ihre Quellen.
-4. Frage nach genau der offenen Information, die das Ergebnis am ehesten ändern würde.
-   Wenn der Benutzer ohne diese Information entscheiden will, halte die Unsicherheit fest.
-5. Schreibe nach seiner Auswahl einen kurzen Entscheidungsvermerk: Frage, Kriterien, gewählte
-   Option, verbleibende Unsicherheit und ein konkreter nächster Schritt. Die Entscheidung bleibt
-   beim Benutzer. Erkläre danach knapp, welche Schritte dieser wiederverwendbare Ablauf geführt hat.
+1. Ask about the decision, the known alternatives, and the most important constraint.
+   If the subject is still missing, begin only with this question and end the turn until the answer.
+   Do not invent personal priorities. A suitable optional example is the question
+   whether a neighborhood event should take place indoors or outdoors.
+2. State the decision in one sentence. Suggest at most three verifiable criteria
+   that fit the answer. Let the user add missing criteria or change priorities.
+3. Compare the alternatives in a short table. Separate known facts and
+   assumptions; do not treat unknown costs or properties as facts. You research external information
+   only with tools that are actually available and mark their sources.
+4. Ask for exactly the open piece of information that would most likely change the result.
+   If the user wants to decide without this information, record the uncertainty.
+5. After their choice, write a short decision note: question, criteria, chosen
+   option, remaining uncertainty, and a concrete next step. The decision stays
+   with the user. Then briefly explain which steps this reusable flow guided.
 
-Der Abschluss ist der Vermerk im Chat. Es wird nichts gebucht, verschickt oder außerhalb des
-Gesprächs verändert. Behaupte keinen Abschluss, solange die Auswahl noch offen ist.
+The conclusion is the note in the chat. Nothing is booked, sent, or changed outside the
+conversation. Do not claim a conclusion while the choice is still open.

package/plugins/ragents.reference/skills/learning-sprint/SKILL.md

@@ -1,33 +1,33 @@
 ---
 start: true
-title: "Lernziel in Etappen"
-category: "Zusammenarbeit"
-prompt: "Ich hätte gern eine kurze Lerneinheit mit einer passenden Übung und einem nächsten Lernschritt."
+title: "Learning goal in stages"
+category: "Collaboration"
+prompt: "I would like a short learning unit with a fitting exercise and a next learning step."
 order: 30
-tags: "Anwendungsfall, Konzeptdemo, Skills"
+tags: "Use case, Concept demo, Skills"
 name: learning-sprint
-description: "Zeigt, wie eine wiederverwendbare Skill-Anleitung eine Lerneinheit im Chat an tatsächliche Antworten anpasst, ohne zusätzliche Actors oder Scripts anzulegen."
+description: "Shows how a reusable skill guide adapts a learning unit in the chat to actual answers without creating additional actors or scripts."
 ---
 
-# Lernziel in Etappen
+# Learning goal in stages
 
-Nutze diesen Ablauf für eine kurze interaktive Lerneinheit. Er ist eine Arbeitsanweisung für
-den Koordinator, kein vorgebautes Agententeam und keine automatische Bewertung einer Person.
+Use this flow for a short interactive learning unit. It is a work instruction for
+the coordinator, not a prebuilt agent team and not an automatic assessment of a person.
 
-1. Frage nach dem Thema, einem konkreten Lernziel und der verfügbaren Zeit. Bei einem leeren
-   Einstieg frage zunächst nur nach dem Thema und warte auf die Antwort. Biete bei Bedarf
-   Prozentrechnung im Alltag oder das verständliche Erklären eines Fachbegriffs als Beispiele an.
-2. Stelle eine kleine Einstiegsaufgabe, die ohne Hilfsmittel lösbar ist. Gib die Lösung nicht
-   vor der Antwort preis. Überspringe diesen Schritt, wenn der Benutzer seinen Stand bereits
-   mit einem eigenen Beispiel gezeigt hat.
-3. Leite aus der tatsächlichen Antwort genau einen nächsten Übungsschritt ab. Erkläre das
-   benötigte Prinzip an einem neuen kurzen Beispiel. Kennzeichne Unsicherheit über Fachfragen;
-   erfinde keine Quellen oder Lernergebnisse.
-4. Stelle eine zweite Aufgabe mit verändertem Kontext. Warte wieder auf die Antwort. Gib
-   konkretes Feedback zur Lösung und bei Bedarf einen Hinweis vor der vollständigen Lösung.
-5. Fasse zusammen, was in diesen Antworten bereits gelang und was noch Übung braucht. Vereinbare
-   einen kleinen nächsten Schritt. Erkläre kurz, dass derselbe Ablauf auch für ein anderes
-   Lernziel verwendet werden kann.
+1. Ask about the topic, a concrete learning goal, and the available time. With an empty
+   start, first ask only about the topic and wait for the answer. If needed, offer
+   everyday percentage calculations or explaining a technical term clearly as examples.
+2. Set a small starter exercise that can be solved without aids. Do not reveal the solution
+   before the answer. Skip this step if the user has already shown their level
+   with an example of their own.
+3. Derive exactly one next practice step from the actual answer. Explain the
+   required principle with a new short example. Mark uncertainty about subject-matter questions;
+   do not invent sources or learning results.
+4. Set a second exercise in a changed context. Wait for the answer again. Give
+   concrete feedback on the solution and, if needed, a hint before the complete solution.
+5. Summarize what already worked in these answers and what still needs practice. Agree on
+   a small next step. Briefly explain that the same flow can also be used for another
+   learning goal.
 
-Beende jeden Turn nach einer offenen Aufgabe. Keine erfundenen Benutzerantworten, keine
-Noten oder Diagnosen aus einer einzelnen Antwort und kein automatisches Weitersenden.
+End every turn after an open exercise. No invented user answers, no
+grades or diagnoses from a single answer, and no automatic forwarding.