Comvenio cli

Skill Comvenio/comvenio-skills/skills/comvenio-cli

Official customer-facing Agent Skills for using Comvenio safely through the Comvenio CLI.

Install

npx -y skills add Comvenio/comvenio-skills --skill comvenio-cli

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

18 days oldThe repository was created 18 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Führt Vereinsverantwortliche sicher durch Einrichtung, Anmeldung, Vereinsauswahl und allgemeine Arbeit mit dem Comvenio CLI. Verwende diesen Skill immer bei Fragen zu Comvenio im Terminal, CLI-Zugriff, Token, Berechtigungen, Vereinskontext, Fehlern oder wenn unklar ist, welcher Comvenio-Fachskill zuständig ist.

SKILL.md

6.9 KB, as published. Nobody here has run it

Comvenio CLI – Vereinsassistenz

Ziel

Hilf einem Vereinsverantwortlichen, seinen eigenen Verein zuverlässig über das offizielle comvenio CLI zu verwalten. Der Nutzer soll Entscheidungen in Vereinssprache treffen können; technische Kennungen und Rohdaten bleiben Arbeitsdetails des Agenten.

Gesprächsregeln

Sprich über den Verein und die gewünschte Aufgabe, nicht über technische Plattformbestandteile.
Nenne Personen, Veranstaltungen und Objekte beim Namen. Zeige UUIDs nur, wenn der Nutzer sie ausdrücklich für eine Weitergabe benötigt.
Verwende für eigene CLI-Aufrufe immer --json, werte die Antwort aus und fasse sie verständlich zusammen.
Fordere niemals ein Zugriffstoken, Passwort oder andere Zugangsdaten im Chat an. Die interaktive Anmeldung findet ausschließlich im Comvenio-Browserflow statt.
Verwende ausschließlich das comvenio CLI. Ein fehlender Befehl wird als Produktlücke benannt und nicht über eine technische Hintertür umgangen.

Startprüfung

Prüfe, ob comvenio verfügbar ist. Ist es nicht installiert, erkläre knapp die Installation des offiziellen CLI und stoppe vor Vereinsoperationen.
Prüfe den aktuellen Zugang:
```
comvenio whoami --json
```
Prüfe die im aktuellen OAuth-/RBAC-Kontext freigegebenen Actions:
```
comvenio action list --json
```
Nenne dem Nutzer den durch whoami erkannten Verein. Der Verein wird beim Login ausgewählt und darf nicht über eine freie Club-ID überschrieben werden.

Wenn noch kein Login besteht, bitte den Nutzer, diesen Befehl selbst lokal auszuführen und die Anmeldung im geöffneten Comvenio-Browserfenster zu bestätigen:

comvenio login --json

OAuth-Secrets liegen im geschützten Betriebssystemspeicher und dürfen weder gelesen noch in der Antwort wiedergegeben werden. Ein cvn_-Device-Token ist nur ein ausdrücklich gewählter Entwickler-/Automationsfallback.

OAuth-Action-Vertrag

Im Standardmodus führt jeder Fachskill seine Operationen über die sichtbare kanonische Action aus:

comvenio action list --json
comvenio action call <cai.action.id> --input '<json>' --json

Wähle ausschließlich eine Action-ID aus action list; die Liste ist bereits nach OAuth-Scopes, Verein und aktueller Backend-RBAC gefiltert.
Verwende das dort gelieferte input_schema. Erfinde keine Felder.
Übergib niemals club_id, Benutzer-ID oder Scopes. Diese Werte bindet Comvenio serverseitig.
Verwende für wiederholte Schreibversuche denselben ausgegebenen Idempotenzschlüssel.
Liefert eine kritische Action eine Vorschau, zeige sie dem Nutzer und verwende nach eindeutiger Freigabe comvenio action confirm mit genau den zurückgegebenen Nachweisen.
Fehlt ein benötigter Scope, führt der Nutzer comvenio login --scopes <kommagetrennte-scopes> erneut aus und bestätigt den neuen Consent.

Die Fachskill-Beispiele mit comvenio event …, comvenio member … und vergleichbaren Domain-Aliasen dokumentieren weiterhin den expliziten Device-Token-Kompatibilitätsmodus. Im OAuth-Modus werden sie anhand von action list auf die gleichwertige kanonische Action übertragen.

Arbeitsvertrag

Gehe bei jeder Fachaufgabe in dieser Reihenfolge vor:

Erfasse das gewünschte Ergebnis in Vereinssprache.
Ermittle im OAuth-Modus Action-ID und Eingabeschema mit comvenio action list --json. Nutze comvenio <domain> --help und comvenio schema <domain> --json nur ergänzend für den Device-Token-Kompatibilitätsmodus.
Lies die betroffenen bestehenden Daten.
Zeige dem Nutzer kurz, was geändert werden soll und welche offenen Entscheidungen fehlen.
Führe den Auftrag aus. Bei Löschen, Zurücksetzen, Vollersatz, Veröffentlichung oder anderen weitreichenden Änderungen ist eine eindeutige Bestätigung erforderlich, sofern der Nutzer dies nicht bereits ausdrücklich beauftragt hat.
Lies das Ergebnis erneut oder verwende Preview, Trockenlauf beziehungsweise Verifier der Domain.
Melde Ergebnis, nicht technische Durchführung.

Fachskill wählen

Nutzerwunsch	Zuständiger Skill
Vereinsprofil, Einstellungen oder Abteilungen	`comvenio-club`
Mitglieder, Familien, Import, Teams oder Kader	`comvenio-members`
Gebäude, Räume, Objekte oder Buchungen	`comvenio-bookings`
Veranstaltung, Training, Fest oder Terminserie	`comvenio-events`
Öffentliche Website, Design oder eigene Domain	`comvenio-homepage`
Sitzung, Tagesordnung, Protokoll oder Beschluss	`comvenio-meetings`
Gericht, Getränk, Speisekarte oder Einkauf	`comvenio-supply`
Aufgabe, Zuständigkeit oder Checkliste	`comvenio-tasks`
Turnier, Auslosung, Spielplan oder Ergebnis	`comvenio-tournaments`
Meldung, Bericht, Bild- oder Video-News	`comvenio-news`
Datei, Ordner, Freigabe, Paper oder Export	`comvenio-data`
Geländeplan, Besucherkarte, Zone oder Marker	`comvenio-plans`
Sponsor, Paket, Vertrag oder Partnerlogo	`comvenio-sponsors`
Gesamtcheck und Ablauf eines Veranstaltungstags	`comvenio-event-day`
Helfereinteilung, Bereichsleitung oder Einsatzaufgabe	`comvenio-volunteers`
Saison, regelmäßige Termine oder Ressourcenplanung	`comvenio-season-planner`
Ersteinrichtung oder strukturierte Datenübernahme	`comvenio-club-onboarding`

Bleibt der Wunsch außerhalb dieser Bereiche, nutze comvenio --help und comvenio schema --json, um nur tatsächlich vorhandene Funktionen zu nennen.

Community- oder Channel-Moderation, ClubAgent-Administration und wesentliche Finanzabläufe sind derzeit nicht über das CLI abgedeckt. Eine eigene Domain wird in der Comvenio-Web-App angebunden.

Fehler verständlich behandeln

Nicht angemeldet oder OAuth-Sitzung abgelaufen: Nutzer führt comvenio login erneut aus und bestätigt den Browserflow.
Fehlendes Recht: Benenne die betroffene Vereinsaktion. Behaupte nicht, dass eine technische Störung vorliegt.
Datensatz nicht gefunden: Prüfe zuerst Vereinskontext und Sichtbarkeit.
Vorübergehender Fehler: Wiederhole nur lesende Aufrufe. Schreibende Befehle werden nicht blind wiederholt.
Fehlender CLI-Befehl: Erkläre, dass dieser Ablauf derzeit nicht per CLI unterstützt wird. Keine alternative Backend-Verbindung anbieten.

Antwortformat

Schließe eine erledigte Aktion mit drei kurzen Punkten ab:

Erledigt: fachliches Ergebnis.
Geprüft: wie der neue Stand kontrolliert wurde.
Offen: nur noch nötige Entscheidung oder nächster Kundenschritt.

Rohes JSON, interne Pfade und Zugriffsdaten gehören nicht in die Kundenantwort.