Rakenne-Skills mit dem Skill Workshop erstellen

Rakenne-Skills sind Dokument-Elaborations-Workflows, die der Agent ausführen kann, wenn Nutzer eine Aufgabe beschreiben. Der Skill Workshop ist ein dedizierter Projekttyp, mit dem Sie eigene Skills im Dialog mit dem Agenten erstellen und veröffentlichen können — ohne Code. Dieses Tutorial führt Sie durch den gesamten Ablauf: vom Anlegen eines Workshop-Projekts bis zur Veröffentlichung einer Skill in der Bibliothek Ihrer Organisation.

Was Sie brauchen

• Zugang zu einer Rakenne-Instanz, in der Sie Projekte anlegen können.
• Eine klare Vorstellung eines Domänen-Workflows, den Sie in eine Skill überführen möchten (z. B. „Protokolle aus Transkripten erstellen“, „Verträge anhand unseres Playbooks prüfen“, „Compliance-Checkliste aus Regulation X erstellen“).

Schritt 1: Skill-Workshop-Projekt anlegen

1. Starten Sie in Rakenne Projekt erstellen (oder Entsprechendes in Ihrer Oberfläche).
2. Wählen Sie beim Projekttyp Skill Workshop.
3. Vergeben Sie einen Projektnamen (z. B. „Meine Skill-Erstellung“) und legen Sie es an.

Der Workspace wird bereitgestellt mit:

• Skill-creator-Skill — Eine integrierte Skill unter .pi/skills/skill-creator/, die den Erstellungs-Workflow steuert.
• AGENTS.md — Anweisungen, die dem Agenten mitteilen, dass dies ein Skill-Erstellungs-Workspace ist und Skills in output/ abgelegt werden.
• output/ — Ein leeres Verzeichnis, in dem jede von Ihnen erstellte Skill liegt (ein Unterverzeichnis pro Skill).

Sie nutzen denselben Workspace wie gewohnt: Chat mit dem Agenten, Dateibaum, Dokumentvorschau. Der Unterschied liegt nur in der Vorlage und im Ziel: Skills statt eines einzelnen Dokuments.

Schritt 2: Erstellungs-Dialog starten

Öffnen Sie das Projekt und beschreiben Sie im Chat, was Sie bauen möchten. Zum Beispiel:

• „Ich möchte eine Skill erstellen, die Besprechungs-Transkripte in strukturierte Notizen mit Entscheidungen und Action Items umwandelt.“
• „Wir brauchen eine Skill, die bei der Erstellung von Privacy-Impact-Assessments mit unserer internen Vorlage und PIPEDA hilft.“

Der Agent nutzt die skill-creator-Skill und erstellt keine Dateien, bis er Ihren Workflow verstanden hat. Er stellt Ihnen strukturiert Fragen (Elicit-Phase).

Schritt 3: Elicitation-Fragen beantworten

Der Agent fragt nach:

1. Wofür der Workflow ist — Domäne und Aufgabe (z. B. Besprechungsnotizen, Vertragsprüfung, Compliance).
2. Was ihn auslöst — Wann jemand diese Skill nutzen würde (z. B. „wenn der Nutzer ein Transkript hat und strukturierte Notizen möchte“).
3. Welche Schritte dazugehören — Die Abfolge (z. B. Eingabe erhalten → Entscheidungen und Aktionen extrahieren → Unklarheiten klären → Dokument erzeugen).
4. Wie die Ausgabe aussieht — Dokumenttyp, Abschnitte, Format (z. B. Executive Summary, Entscheidungslog, Action Items).
5. Domänenwissen — Vorschriften, Standards, Vorlagen oder Referenzmaterial, die der Agent nutzen soll.

Antworten Sie in einfacher Sprache. Der Agent formt Ihre Antworten in eine strukturierte Skill; Sie müssen kein Markdown oder YAML beherrschen. Bei Vorlagen oder Referenzdokumenten können Sie sie später hinzufügen oder beschreiben, damit der Agent Platzhalter referenzieren kann.

Schritt 4: Agent Gerüst und Skill schreiben lassen

Sobald der Agent genug Informationen hat, wird er:

1. Einen Slug wählen — Einen Kebab-Case-Bezeichner (z. B. meeting-notes, contract-review-playbook).
2. scaffold_skill aufrufen — Das legt output/{slug}/ mit einer SKILL.md-Vorlage und optional references/ und assets/ an.
3. SKILL.md bearbeiten — Er füllt die Workflow-Schritte, Verweise auf Referenzdateien und Trigger-Formulierungen in der Beschreibung ein.
4. Referenz- und Asset-Dateien hinzufügen — Domänenwissen in references/; Ausgabe-Vorlagen oder Beispiele in assets/.

All das passiert im Chat; Sie können den Dateibaum beobachten und Dateien zur Prüfung öffnen. Skills werden nur unter output/ geschrieben.

Schritt 5: Validieren und verfeinern

Bevor die Skill als fertig gilt, führt der Agent validate_skill aus. Geprüft wird:

• SKILL.md existiert und hat gültiges YAML-Frontmatter (name, description).
• Beschreibungsqualität — Die Beschreibung enthält Trigger-Sprache (z. B. „Use when…“, „Use for…“).
• Körperlänge — SKILL.md-Body unter 500 Zeilen (längerer Inhalt gehört in references/).
• Referenz-Integrität — Links in SKILL.md zeigen auf existierende Dateien; keine kaputten Links.
• metadata.json — Vorhanden und gültig (oder Hinweis, dass sie fehlt; Sie ergänzen sie im nächsten Schritt).

Schlägt etwas fehl, schlägt der Agent Korrekturen vor (z. B. Trigger-Sprache ergänzen, Pfad korrigieren, Inhalt in Referenzdatei verschieben). Sie können im Chat nachbessern und erneut validieren, bis alle Prüfungen bestehen.

Schritt 6: Metadaten für die Bibliothek vorbereiten

Wenn Sie mit dem Inhalt der Skill zufrieden sind, bereitet der Agent die Veröffentlichung vor:

1. preview_metadata ausführen — Zeigt, wie die Skill in der Bibliothek erscheinen wird. Fehlt metadata.json, wird ein Entwurf aus dem SKILL.md-Frontmatter erzeugt.
2. metadata.json bearbeiten — Gemeinsam setzen Sie title (lesbarer Name für die Bibliothek), description (kurze Zusammenfassung), tags (domänenorientiert, englische Nomen, z. B. „Productivity“, „Meetings“, „Legal“, „Compliance“) und examples (zwei bis drei Beispiel-Prompts).
3. Erneut validieren — Eine letzte validate_skill stellt sicher, dass Metadaten und Struktur vollständig sind.

Danach teilt der Agent mit, dass die Skill bereit zur Veröffentlichung ist.

Schritt 7: In Ihre Bibliothek veröffentlichen

1. Klicken Sie in der Projekt-Workspace-Symbolleiste auf Publish Skill.
2. Ein Dialog listet die Skills in Ihrem output/-Verzeichnis (jeder Ordner mit einer SKILL.md). Wählen Sie die zu veröffentlichende Skill.
3. Bestätigen. Das Frontend ruft die Publish-API auf; die Skill wird in die Skill-Bibliothek Ihrer Organisation kopiert und im Katalog registriert.
4. Sie erhalten eine Erfolgsmeldung (z. B. „Skill in Bibliothek veröffentlicht“). Die Skill steht beim Installieren von Skills in jedem Projekt Ihres Tenants zur Verfügung. Erneutes Veröffentlichen desselben Slugs aktualisiert die bestehende Skill.

Aufbau einer Rakenne-Skill

Eine minimale Skill in output/{slug}/ sieht so aus:

• SKILL.md — Pflicht. YAML-Frontmatter mit name (Slug) und description (inkl. Trigger-Sprache). Body: Workflow-Schritte, Regeln, Links zu Referenzen.
• metadata.json — Pflicht für die Veröffentlichung. title, description, tags (Array), examples (Array von Beispiel-Prompts). Wird von der Bibliothek-Oberfläche genutzt.
• references/ — Optional. Markdown- (oder andere) Dateien mit Domänenwissen; aus SKILL.md verlinkt, damit der Agent sie im Workflow lesen kann.
• assets/ — Optional. Vorlagen oder statische Assets, die der Agent bei der Ausgabe nutzt (z. B. meeting_notes_template.md).

Der skill-creator-Workflow hält SKILL.md knapp und legt detaillierten Inhalt in references/ ab, damit der Agent einen klaren, scanbaren Workflow und bei Bedarf reichen Kontext hat.

Tipps

• Ein Workflow pro Skill — Bei mehreren getrennten Workflows erstellen Sie eine Skill pro Workflow; Sie können mehrere Skills im selben Workshop-Projekt anlegen (jede in eigenem output/{slug}/).
• Trigger-Sprache ist wichtig — Der Agent nutzt die description der Skill, um zu entscheiden, wann er sie aktiviert. Formulierungen wie „Use when the user wants to…“, „Use for drafting…“ oder „Use to generate…“ helfen bei der Zuordnung zur Nutzerabsicht.
• Im Workshop iterieren — Sie können das Projekt jederzeit wieder öffnen, Dateien bearbeiten oder mit dem Agenten chatten, die Skill anpassen, erneut validieren und Publish Skill erneut ausführen, um die Bibliothekskopie zu aktualisieren.
• Kein extension.ts für Domänen-Skills — Der Skill Workshop ist für markdown-basierte Skills (SKILL.md + references + assets). TypeScript-Erweiterungen liegen außerhalb des geführten Workflows; der skill-creator erstellt oder bearbeitet kein extension.ts.

Nächste Schritte

• Nutzen Sie Session Management and Context Hygiene , damit jede Erstellungsaufgabe in einer fokussierten Session bleibt.
• Lesen Sie Rakenne 0.2.0 — Skill Workshop und mehr für den vollen Funktionsumfang und die Skill-Bibliothek-Verbesserungen.
• Nach der Veröffentlichung installieren Sie Ihre Skill in einem Dokument-Elaborations-Projekt und führen Sie einige Beispiel-Prompts aus, um das Verhalten zu prüfen.