Famulor Skill - Famulor

Famulor Skill zeigt deinem KI-Client, wie er Assistenten gestaltet und mit Famulor arbeitet. Enthalten sind Prompt-Vorlagen, Anleitungen für die einzelnen Kanäle, Testszenarien sowie Referenzen für die öffentliche API, MCP, CLI und das TypeScript-SDK. Repository ansehen · Aktuelles Release herunterladen · Ausführliche Installationsanleitung

Der Skill liefert Arbeitsanweisungen. Eine MCP-Verbindung ermöglicht den autorisierten Workspace-Zugriff. Die Skill-Installation verbindet dein Konto nicht automatisch und erweitert keine vorhandenen Berechtigungen. Prompts kannst du ohne Verbindung entwerfen; für das Lesen oder Ändern von Workspace-Daten brauchst du eine Verbindung.

Wähle deinen Einstieg

Du möchtest …	Beginne hier
Einen Telefonempfang oder Buchungsassistenten bauen	Assistenten-Design und Voice-Vorlagen
Einen Assistenten an WhatsApp, Webchat oder E-Mail anpassen	Kanalanleitung und Prompt-Beispiele
Die Gesprächsqualität verbessern	Tests und Auswertung
Einen Endpunkt, CLI-Befehl oder eine SDK-Methode finden	API- und SDK-Anleitung
Kampagnen, Wissensquellen oder Automatisierungen vorbereiten	Workflow-Beispiele und MCP-Anwendungsfälle

Vollständige Beispiele

Die Beispielsammlung zeigt vollständige Assistenten-Entwürfe, inspiriert von den öffentlichen Famulor-Demos.

Beispiel	Was es zeigt
Hotelrezeption	Begrüßung, Hotelwissen, echte Verfügbarkeit, Buchungsbestätigung und Fehlerbehandlung
Drive-thru	Warenkorb korrigieren, Angebot prüfen und genau einmal bestellen
Bestellsupport	Gemeinsame Geschäftsregeln mit Anpassungen für Voice, WhatsApp, Webchat und E-Mail
Lead-Qualifizierung	Sinnvolle Fragen, passende nächste Schritte und respektierter Kontaktverzicht

Jedes Beispiel enthält ein ausgefülltes Briefing, einen vollständigen Prompt, die Zuordnung zu Einstellungen, benötigte Laufzeit-Tools, ein illustratives Gespräch und Prüfkriterien. Die Muster-Ausarbeitung zeigt, wie ein Agent den fertigen Vorschlag und seinen Prüfstatus präsentieren soll. Unternehmen und Beispielergebnisse sind fiktiv: Ein Demo-Rollenspiel belegt keine echte Buchung oder Bestellung. Dafür müssen reale Tools verbunden und ihre Ergebnisse geprüft werden. Die vollständigen Beispiele im Repository sind auf Englisch.

Installation

Für Coding-Agenten mit Agent-Skills-Unterstützung:

npx skills add bekservice/Famulor-Skill --skill famulor-skill

Wähle deinen Client im Installer. Standardmäßig wird im aktuellen Projekt installiert; mit -g installierst du global. Prüfe das Paket vor der Installation. Für Workspace-Aktionen füge eine entfernte Streamable-HTTP-MCP-Verbindung hinzu und melde dich über OAuth an:

https://app.famulor.io/mcp

Für einen Whitelabel-Workspace verwendest du die Domain aus Settings → API & MCP. Dein Plan muss Connect AI / MCP enthalten; Workspace-Rolle und freigegebene Scopes müssen die Aktion erlauben. Eine gezielte URL wie https://app.famulor.io/mcp?toolsets=assistants,calls begrenzt die Tool-Auswahl, ohne zusätzliche Rechte zu vergeben.

Installiere das vollständige Plugin aus dem Marketplace des Repositorys:

/plugin marketplace add bekservice/Famulor-Skill
/plugin install famulor@famulor

Öffne /mcp und authentifiziere Famulor. Dieses Paket enthält Skill und MCP-Konfiguration. Wenn du nur den Skill über npx skills installiert hast, ergänze die Verbindung separat:

claude mcp add --transport http famulor https://app.famulor.io/mcp

Lade famulor-skill.zip aus dem aktuellen Release herunter.
Öffne Customize → Skills → + → Create skill → Upload a skill und lade diese ZIP hoch. Verwende nicht die ZIP des gesamten Repositorys.
Aktiviere den Skill. Dein Konto oder deine Organisation muss Skills und Codeausführung erlauben.
Verbinde Famulor unter Customize → Connectors. Nutze für die benötigten Tools einen eigenen Connector mit der MCP-URL.
Starte einen neuen Chat und bitte Claude, Famulor Skill zu verwenden.

Der Verzeichnis-Connector Famulor Assistants & History bietet Lesezugriff. Er kann keine Prompts speichern oder Nachrichten senden. Bei abweichenden Bedienelementen hilft Claudes Anleitung zum Skill-Upload.

Richte nach der Skill-Installation MCP ein und prüfe die Verbindung:

codex mcp add famulor --url https://app.famulor.io/mcp
codex mcp login famulor
codex mcp get famulor

Starte die Sitzung neu und bitte Codex, $famulor-skill zu verwenden. In IDE-Clients kannst du die Verbindung auch unter MCP servers → Add server → Streamable HTTP ergänzen.

Wähle Cursor im Skill-Installer. Ergänze die entfernte URL in den MCP-Einstellungen oder verwende diese Projektkonfiguration in .cursor/mcp.json:

{
  "mcpServers": {
    "famulor": {
      "url": "https://app.famulor.io/mcp"
    }
  }
}

Authentifiziere dich bei Aufforderung und prüfe, ob die Famulor-Tools aktiviert sind.

Installiere die Erweiterung mit Skill und MCP-Konfiguration:

gemini extensions install https://github.com/bekservice/Famulor-Skill

Prüfe die angeforderten Fähigkeiten. Führe bei Bedarf /mcp auth famulor zur Anmeldung aus und kontrolliere die Installation mit /extensions list.

Für andere kompatible Clients verwende den Installer oder kopiere den vollständigen Ordner skills/famulor-skill/ einschließlich Referenzen, Skripten und Vorlagen. Nur SKILL.md zu kopieren lässt die ergänzenden Anleitungen weg. Das Release bietet außerdem famulor.skill für kompatible Importfunktionen.

Verbindung mit einem Lesezugriff prüfen

Liste mit Famulor meine Assistenten auf. Sag mir, welcher Workspace verbunden ist. Ändere nichts.

Anschließend kannst du eine gezielte Prüfung starten:

Prüfe mit Famulor Skill meinen Support-Assistenten für Website-Textchat. Schlage einen verbesserten Prompt und drei Testgespräche vor. Speichere und sende nichts.

Ein heruntergeladenes Paket oder eine abgeschlossene OAuth-Anmeldung beweist noch keinen erfolgreichen Tool-Aufruf. Prüfe, ob der Client echte Daten aus dem richtigen Workspace liefert. Eine Leseverbindung reicht für Analysen und Entwürfe; zum Speichern brauchst du passende Schreibrechte.

Prompts passend zum Kanal

Geschäftsregeln, vertrauenswürdige Quellen und Aktionsregeln gehören in den gemeinsamen System-Prompt. Nutze Additional channel instructions für Ton, Länge und Darstellung, wenn dein Plan manuelle Kanalantworten enthält.

Voice: kurze gesprochene Antworten, eine klare Frage, eine passende Begrüßung und tatsächlich konfigurierte Übergabe- oder Buchungstools.
WhatsApp: kompakte Nachrichten, menschliche Übernahme, das aktuelle Servicefenster und freigegebene Vorlagen für autorisierte Kontaktaufnahme, wenn erforderlich.
Webchat: lesbare Links, Angaben aus dem Kontaktformular, hilfreiche schriftliche Antworten und ein Test des tatsächlichen Widgets.
E-Mail: vollständiger Nachrichtentext, korrekter Thread und passende Signatur sowie eine klare Unterscheidung zwischen Entwurf und gesendeter Antwort.

Ein Prompt kann keinen Kalender verbinden, kein Tool erstellen, keine Berechtigung erteilen und keine Zustellung nachweisen. Der Skill führt den Client durch Konfigurationsprüfung, Auflösung echter Ressourcen-IDs, unterstützte Aktionen und Ergebnisprüfung. Beginne mit den Anwendungsbeispielen und teste den Kanal, den deine Kunden tatsächlich verwenden.

Aktualisierung und Fehlerbehebung

Bei einer Installation über den Installer führe npx skills check und danach npx skills update aus. Einen manuell hochgeladenen Claude-Skill ersetzt du durch die ZIP des aktuellen Releases. Die MCP-Autorisierung bleibt separat; das Löschen lokaler Dateien widerruft nicht automatisch den OAuth-Zugriff.

Symptom	Nächster Schritt
Skill installiert, aber keine Tools	MCP-Verbindung ergänzen, anmelden und die Client-Sitzung neu starten.
Nur 11 Lese-Tools	Du verwendest das Verzeichnisprofil. Für weitere Aktionen brauchst du eine separat autorisierte eigene Verbindung.
Assistent lässt sich nicht speichern	Workspace, Rolle, freigegebene Scopes und Plan prüfen.
Zeitüberschreitung beim Schreiben	Vor dem erneuten Versuch den Zustand lesen; die erste Aktion könnte bereits abgeschlossen sein.
Andere Installationsbedienelemente	Die gepflegte Installationsanleitung und die offizielle Client-Dokumentation beachten.

Melde reproduzierbare Skill- oder Dokumentationsprobleme über die Repository-Issues. Entferne Kundendaten und Zugangsdaten aus Beispielen. Bei kontospezifischen Fragen hilft der Famulor-Support.

​Wähle deinen Einstieg

​Vollständige Beispiele

​Installation

​Verbindung mit einem Lesezugriff prüfen

​Prompts passend zum Kanal

​Aktualisierung und Fehlerbehebung

Wähle deinen Einstieg

Vollständige Beispiele

Installation

Verbindung mit einem Lesezugriff prüfen

Prompts passend zum Kanal

Aktualisierung und Fehlerbehebung