Fiktive Modellfirma im AI-PA Bildungskontext — keine echte Marke
Boxenwerk GmbH & Co. KG BoxenwerkMotorsport-Teile
☰
2-Tage-Workshop Kurs Vorbereitung Prompting Tag 1 Tag 2 Hermes Agent Hermes · Überblick Hermes-Basics Use Cases Profile Cronjobs Workflows & Bundles Kanban Dashboard Selbst lernen & SOUL.md Skills & /learn Übungs-Workbook Lia-Kurs Modellfirma Produkte KI-Agenten Berater Daten Über uns
Lernpfad 1 · Hermes-Basics → 2 · Prompting → 3 · Tag 1 → 4 · Tag 2 Fortschritt 0% Kurs · sichern →
Tag 2 · Werkstatt

Agenten bauen

Vom Live-Build des Reporting-Agents bis zum eigenen Skill. Eine Station pro Screen — alle Prompts und Befehle sind kopierbar und werden erklärt.

Deine Lernziele auf dieser Seite
  • ✓die drei Bausteine Skill, Bundle und Subagent unterscheiden und den passenden zur Aufgabe wählen
  • ✓einen /reporting-agent laufen lassen, dessen Zahlen nur aus der Source of Truth stammen
  • ✓zwei End-to-End-Workflows durchspielen und per /learn einen eigenen Skill anlegen
  • ✓am Ende einen lauffähigen eigenen Agenten für eine echte Aufgabe vorzeigen
09:30 · Tour 11:00 · Reporting 13:30 · Workflows 14:30 · Skill 15:45 · Solo
Ergebnis zuerst

Das baust du heute

Bevor wir loslegen: So sieht das Ziel aus. Der Reporting-Agent zieht sich die Zahlen aus der Datei und baut daraus Schritt für Schritt einen fertigen Weekly Report — genau das machst du gleich selbst.

→ Das Ergebnis

Ein sauberer Report mit Executive Summary, KPI-Tabelle und Alerts — jede Zahl exakt aus der Datei, nichts erfunden. Wie du dahin kommst, baust du auf dieser Seite Station für Station.

Los geht's — Architektur-Tour↓
Kurz aufgewärmtDrei Fragen zum Vortag (Tag 1) — erst selbst antworten, dann aufklappen.
Recall — Cockpit oder Werkstatt: was ist der Unterschied?
Im Cockpit (Tag 1) steuerst du fertige Agenten und gibst Aufträge. In der Werkstatt (Tag 2) baust du selbst — du setzt Skills zusammen und legst eigene an.
Recall — Was passiert, wenn du einen Skill aufrufst?
Der Skill-Befehl (z. B. /reporting-agent …) ruft eine hinterlegte Anleitung auf: eine feste Procedure plus ihre Datenquelle. Der Agent führt diese Schritte aus, statt frei zu improvisieren.
Recall — Source of Truth: warum keine erfundenen Zahlen?
Zahlen kommen ausschließlich aus einer definierten Quelle (z. B. marketing-weekly.json). Schätzt oder erfindet der Agent Werte, ist der Report unbrauchbar — fehlt eine Zahl, sagt er das, statt zu raten.
09:30 · Demo
LernzielNach dieser Übung kannst du die Bausteine eines Agenten benennen und einen Skill live sehen VoraussetzungHermes läuft im Terminal Dauer10 min

Architektur-Tour

Ziel: Das Vokabular verstehen und einen Skill live sehen — bevor du selbst baust.

Warum das?Ohne das gemeinsame Vokabular — Hands, Tools, Channels — verstehst du später nicht, was du eigentlich zusammenbaust.
Die drei Bausteine im Detail — aufklappen
Hands
Subagents · delegate_task
Tools
Tool Gateway · web_search
Channels
CLI · Telegram optional
hermes chat -q "Welche Boxenwerk Workshop-Skills hast du?"
Was macht der Befehl?

hermes chat -q stellt eine einmalige Frage ohne TUI und gibt die Antwort direkt im Terminal aus — ideal für schnelle Checks. Hier: listet die installierten Workshop-Skills auf.

Skizze: 3 Boxen — Inputs · Procedure · Outputs — und 1 Pfeil zu einem Tool.

Testfrage — Unterschied zwischen Hands und Tools?
Hands = Subagents (delegate_task), die Teilaufgaben übernehmen. Tools = Fähigkeiten über das Tool Gateway (z. B. web_search). Channels = Zugänge wie CLI oder Telegram.
Lösung / Erwartetes Ergebnis
Der Befehl gibt eine Liste der installierten Workshop-Skills im Terminal aus — u. a. /reporting-agent, /sponsoring-scout und /content-pipeline. Erscheint keine Liste, ist das Paket noch nicht registriert.
▶ So sieht's aus// Architektur-Tour: Hands, Tools, Channels
Weiter — Live-Demo↓
◆ Lerneinheit · Theorie

Source of Truth

ZielNach diesem Abschnitt kannst du erklären, warum ein Reporting-Agent seine Zahlen nur aus einer Datei nimmt — und einen Report darauf prüfen.
Warum das?Nur so kannst du dem Report trauen: Eine erfundene Zahl in einem Weekly Report führt zu falschen Entscheidungen.

Der Reporting-Agent erfindet keine Zahlen. Alles kommt aus einer Datei — das ist das wichtigste Prinzip beim Reporting.

Source of Truth im Detail — aufklappen
Eine Quelle

marketing-weekly.json ist die Wahrheit. Der Agent liest sie und rechnet nicht dazu.

Keine Schätzung

Fehlt eine Zahl, sagt der Agent das — statt zu raten oder zu halluzinieren.

Stichprobe zum Prüfen

Im Report muss social_reach = 2.840.000 stehen — exakt wie in der JSON. Stimmt das nicht, ist der Report falsch.

Oft gehört — klargestellt
Oft gehört

„Der Agent rechnet die KPIs schon selbst aus."

Tatsächlich

Er rechnet nichts dazu. Er nimmt die fertigen Werte aus der Source of Truth (marketing-weekly.json) und schreibt sie unverändert in den Report.

Besser so

Sieh die Datei als einzige Wahrheit: Willst du andere Zahlen im Report, änderst du die Datei — nicht den Prompt.

Testfrage — Woran erkennst du, dass ein Report echte Zahlen hat?
Die Werte müssen exakt der Source of Truth entsprechen — z. B. social_reach = 2.840.000 aus marketing-weekly.json. Weicht eine Zahl ab, hat der Agent halluziniert.
Weiter — Live-Demo↓
▶ Lerneinheit · Video

Live-Demo: So entsteht ein Report

ZielNach diesem Abschnitt hast du einen kompletten Report-Lauf einmal gesehen — und weißt, was gleich in deinem Terminal passiert.
Warum das?Einmal zusehen nimmt die Unsicherheit: Du erkennst die Schritte wieder, wenn du sie selbst auslöst.

Schau zu, wie der Reporting-Agent aus marketing-weekly.json Schritt für Schritt einen sauberen Weekly Report baut — bevor du es selbst machst.

YouTube-Erklärvideo / Live-Demo
// hier <iframe>-Embed (YouTube · Vimeo · Loom) einsetzen
↗ Miro-Board↗ YouTube-Playlist↗ Slides / Doku

Video-Embed & Links werden vom Trainer gesetzt. Für ein interaktives Board lässt sich hier auch ein Miro-iFrame in voller Breite einbetten.

▶ Probier's aus// in Hermes Agent oder Claude Code einfügen
/reporting-agent Erstelle den Marketing-Weekly-Report für W26 und erkläre kurz, woher jede Zahl kommt.
Jetzt selbst — Reporting↓
11:00 · Live-Build/reporting-agent
LernzielNach dieser Übung kannst du einen Reporting-Agenten laufen lassen und live erweitern VoraussetzungArchitektur-Tour Dauer20 min

Reporting-Agent

Ziel: Jeder hat einen funktionierenden /reporting-agent — Zahlen nur aus JSON, kein Halluzinieren.

Warum das?Reporting ist die häufigste Agenten-Aufgabe im Alltag — und der beste Ort, um die Source-of-Truth-Regel zu verinnerlichen.
1 · Testen
/reporting-agent Erstelle den Marketing-Weekly-Report für W26
2 · Live erweitern
/reporting-agent Füge eine Express-Auftrags-Sektion hinzu — nutze express-auftraege.json, zähle offen vs in Fertigung
Was hier passiert im Detail — aufklappen
Was passiert?

Der Skill liest marketing-weekly.json als Source of Truth und baut den Report. In Schritt 2 erweiterst du ihn live um eine Sektion aus einer zweiten Datei — so verstehst du, wie ein Skill wächst.

Erfolgskriterium
  • Executive Summary, KPI-Tabelle, Alerts
  • Zahlen = JSON (Stichprobe: social_reach = 2.840.000)
  • Footer-Disclaimer vorhanden
Testfrage — Warum darf der Agent keine KPIs schätzen?
Alle Zahlen kommen ausschließlich aus marketing-weekly.json. Stichprobe: social_reach = 2.840.000. Erfundene Werte gelten als Fehler.
Lösung / Erwartetes Ergebnis
Ein Report mit Executive Summary, KPI-Tabelle und Alerts — jede Zahl exakt aus der JSON (Stichprobe: social_reach = 2.840.000), plus Footer-Disclaimer. Nach Schritt 2 enthält er zusätzlich eine Express-Auftrags-Sektion mit offen- vs. in-Fertigung-Zählung. Weicht eine Zahl ab, hat der Agent halluziniert.
▶ So sieht's aus// Reporting-Agent: Collector sammelt die Zahlen
▶ So sieht's aus// Reporting-Agent: Analyst wertet aus
▶ So sieht's aus// Reporting-Agent: Formatter baut den Report
▶ So sieht's aus// Reporting-Agent: die ganze Pipeline
Weiter — Workflows↓
13:30 · Workflows
LernzielNach dieser Übung kannst du zwei End-to-End-Workflows durchspielen und Skill von Bundle unterscheiden VoraussetzungReporting-Agent Dauer20 min

Zwei reale Workflows

Ziel: Zwei End-to-End-Workflows durchspielen — Lead-Recherche und Content.

Warum das?Erst wenn du beide Fälle selbst gespielt hast, spürst du, wann ein einzelner Skill reicht und wann ein Bundle die bessere Wahl ist.
Workflow A · Lead-Recherche
/sponsoring-scout Identifiziere alle Anfragen in Stage proposal mit Auftragswert über 150k. Ranke nach Fit für unsere Kleinserien-Fertigung. Erstelle Anschreiben-Entwurf für die Top-Anfrage.
Workflow B · Kunden-Update
/content-pipeline Liefertermin-Update für Velox Racing nach Prüfung von Charge 4. Max ein kurzer Absatz.
Skill vs. Bundle im Detail — aufklappen
Worum geht's?

Zwei typische Business-Aufgaben: einmal ein einzelner Skill (Scout) mit komplexem Filter, einmal das Pipeline-Bundle für Content. Du spürst, wann ein Skill reicht und wann ein Bundle besser ist.

Testfrage — Wann reicht ein Skill, wann braucht es ein Bundle?
Ein Skill für einen klaren Einzelschritt; ein Bundle (z. B. content-pipeline) für mehrstufige Workflows; Subagents, wenn Schritte parallel laufen sollen.
Lösung / Erwartetes Ergebnis
Workflow A liefert nur Anfragen in Stage proposal mit Auftragswert über 150k, nach Fertigungs-Fit gerankt, plus einen Anschreiben-Entwurf für die Top-Anfrage. Workflow B liefert ein Liefertermin-Update für Velox Racing in einem kurzen Absatz. Tauchen Anfragen aus anderen Stages oder mit kleinerem Wert auf, wurde der Filter ignoriert.
▶ So sieht's aus// Workflow A: Lead-Recherche
▶ So sieht's aus// Workflow B: Kunden-Update
▶ So sieht's aus// Workflow C: CRM
Weiter — Lerneinheit↓
◆ Lerneinheit · Theorie

Skill, Bundle oder Subagent?

ZielNach diesem Abschnitt kannst du Skill, Bundle und Subagent unterscheiden und für eine Aufgabe den passenden benennen.
Warum das?Wählst du den falschen Baustein, wird dein Agent unnötig kompliziert — die richtige Wahl spart Schritte und Fehler.

Drei Bausteine bilden jeden Hermes-Agenten. Bevor du baust: Wann nimmst du welchen?

Die drei Bausteine im Detail — aufklappen
Skill

Ein klarer Einzelschritt — eine Procedure + ihre Datenquelle.

/reporting-agent
Bundle

Mehrere Skills als feste Kette, nacheinander aufgerufen.

/content-pipeline
Subagents · Hands

Mehrere Teilaufgaben parallel — über delegate_task.

delegate_task
Merksatz

Einzelschritt → Skill. Mehrstufig & sequenziell → Bundle. Parallel → Subagents.

▶ Probier's aus// in Hermes Agent oder Claude Code einfügen
/content-pipeline Liefertermin-Update für Velox Racing nach Charge-3-Freigabe — zeig mir, welcher Layer (Researcher/Writer/Editor) was beigetragen hat.
Testfrage — Fester, mehrstufiger Ablauf — Skill, Bundle oder Subagents?
Ein Bundle (z. B. /content-pipeline): mehrere Skills als feste, sequenzielle Kette. Einzelschritt = Skill, parallele Teilaufgaben = Subagents.
Quellen & Syntax
Syntax
/skill-name [Auftrag in Alltagssprache] /bundle-name [mehrstufiger Auftrag] # ruft die Kette auf
Weiterlesen
  • ↗ Hermes Skills — Doku
  • ↗ SKILL.md-Format (agentskills.io)
  • ↗ Skill-Bundles — YAML-Aufbau

Links vom Trainer setzen.

Jetzt selbst bauen↓
14:30 · Skill bauen/learn
LernzielNach dieser Übung kannst du einen eigenen Workflow per /learn in einen Skill verwandeln VoraussetzungSkill / Bundle / Subagent verstanden Dauer15 min

Sprache → Skill

Ziel: Einen wiederholbaren Workflow in einen Skill verwandeln — in Alltagssprache.

Warum das?Mit /learn machst du aus einer einmaligen Aufgabe einen wiederholbaren Handgriff — das ist der Hebel, der dir echte Zeit spart.
Demo · /learn
/learn Wie ich jeden Montag den Boxenwerk Weekly Report aus marketing-weekly.json erstelle: KPIs, Top-Aufträge, Alerts, Empfehlungen
Deine Übung
/learn [Dein Workflow in Alltagssprache — z. B. Status-Mail aus Bulletpoints, Meeting-Notes → Action Items]
Was /learn macht im Detail — aufklappen
Was macht /learn?

/learn bringt Hermes einen wiederholbaren Ablauf als neuen Skill bei: Es schreibt eine SKILL.md (When to Use, Procedure, Verification). Danach rufst du ihn mit /skill-name auf.

Testfrage — Was macht einen guten Skill aus?
description ≤ 60 Zeichen, klares When to Use, nummerierte Procedure und ein definiertes Verification-Kriterium.
Lösung / Erwartetes Ergebnis
Hermes legt eine neue SKILL.md mit When-to-Use, nummerierter Procedure und Verification an. Danach lässt sich der Workflow per /skill-name aufrufen und reproduziert dein beschriebenes Ergebnis. Fehlt eines der drei Frontmatter-Felder, ist der Skill unvollständig.
▶ So sieht's aus// Sprache → Skill: Weekly-Report lernen
Weiter — Solo-Build↓
15:45 · Solo-Build
LernzielNach dieser Übung kannst du einen lauffähigen eigenen Skill für eine reale Aufgabe bauen VoraussetzungSprache → Skill · Transfer-Block Dauer30 min

Eigener Agent

Ziel: Ein lauffähiger Hermes-Skill für eine reale Aufgabe aus deinem Transfer-Block.

Warum das?Ein eigener, lauffähiger Skill ist der Beweis, dass du Agenten künftig selbst an deine Arbeit anpassen kannst.
Option A · Manuell
mkdir -p ~/.hermes/skills/mein-firmen-agent # Frontmatter + Procedure aus dem Steckbrief in SKILL.md kopieren
Option B · /learn  →  dann testen
/mein-firmen-agent [Dein Test-Prompt]
Was der Befehl macht im Detail — aufklappen
Was macht der Befehl?

mkdir -p ~/.hermes/skills/... legt den Ordner für deinen Skill an — genau dort sucht Hermes. Danach testest du ihn mit /mein-firmen-agent.

Checkpoint: Verification-Kriterium aus dem Steckbrief erfüllt? Dann: 90-Sekunden-Präsentation.

Testfrage — Wann ist dein Agent „fertig"?
Wenn das Verification-Kriterium aus dem Steckbrief mit einem echten Test-Prompt erfüllt ist — danach folgt die 90-Sekunden-Präsentation.
Lösung / Erwartetes Ergebnis
Ein Ordner ~/.hermes/skills/<dein-agent>/ mit einer SKILL.md, die per /<dein-agent> aufrufbar ist und mit einem echten Test-Prompt das Verification-Kriterium aus deinem Steckbrief erfüllt. Damit bist du bereit für die 90-Sekunden-Präsentation.
← Tag 1Alle Agenten
Das nimmst du mit
  • 1Skill · Bundle · Subagent — Einzelschritt, feste Kette oder parallel: den Baustein wählst du nach der Aufgabe.
  • 2Source of Truth: Zahlen kommen nur aus der Datei (z. B. marketing-weekly.json) — der Agent erfindet nichts.
  • 3Mit /learn machst du aus einem wiederholbaren Ablauf einen eigenen Skill — und rufst ihn per /skill-name auf.
Kurz wiederholen — dann bleibt's

Sieh dir diese drei Punkte morgen 2 Minuten noch einmal an — einmal aus dem Kopf abrufen bringt mehr als dreimal nachlesen. Als Merkzettel: den Prompt-Spickzettel ausdrucken ↓.