Mote-Fähigkeit
Die mote-Fähigkeit bringt KI-Agenten bei, wann und wie sie Markdown mit Mote veröffentlichen – sie enthält keine eigene Upload-Implementierung, sondern steuert die CLI oder die MCP-Werkzeuge.
Fähigkeiten sind über das skills-Ökosystem CLI installierbar.
Installation
npx skills add flc1125/mote
Nützliche Varianten:
# Vorschau, was das Repository bietet
npx skills add flc1125/mote --list
# Für bestimmte Agenten installieren
npx skills add flc1125/mote -a claude-code -a codex
# Nicht-interaktiv (CI)
npx skills add flc1125/mote --skill mote -g -a claude-code -y
Die Fähigkeit befindet sich unter skills/mote/SKILL.md in diesem Repository.
Sie enthält Codex-Anzeigemetadaten in agents/openai.yaml und gebündelte Mote-Icons
in assets/, sodass das Branding auch dann verfügbar ist, wenn nur das Fähigkeitsverzeichnis
installiert wird. Andere Clients können SKILL.md ohne diese optionalen UI-Metadaten verwenden.
Brand-Artefakte werden in docs/assets gepflegt; führen Sie nach Änderungen node scripts/brand/sync.mjs
aus. Die vorhandene Brand-Prüfung überprüft auch die Icon-Kopien der Fähigkeit.
Was sie tut
Ein installierter Agent, der gebeten wird, Markdown online zu veröffentlichen oder eine teilbare URL zu erstellen, wird:
- Nach lokalen Bildern suchen und einen konfigurierten Veröffentlichungspfad wählen.
publish_markdownakzeptiert Text und entfernte Bild-URLs; lokale Bilder erfordern die CLI oder lokalespublish_markdown_file, wobei Pfade relativ zur Markdown-Datei aufgelöst werden. - Veröffentlichen und das Ergebnis parsen
- Die URL unverändert zurückgeben
Sie kodiert auch die Leitplanken: Niemals Anmeldeinformationen/Geheimnisse veröffentlichen (Mote-URLs sind Fähigkeiten und Dokumente sind unveränderlich), Größenbeschränkungen respektieren und Fehler ehrlich melden.
Das Lesen, Bearbeiten oder Vorschauen eines lokalen Dokuments allein löst keine Veröffentlichung aus. Links zu anderen lokalen Dokumenten veröffentlichen diese Dokumente nicht automatisch. Für Formeln, Diagramme und andere Erweiterungen siehe die Kompatibilitätsreferenz und das Live-Exemplar. Nicht unterstützte Syntax kann lesbare Quelle bleiben, selbst wenn die Veröffentlichung erfolgreich ist.
Anforderungen
Die Fähigkeit selbst ist nur eine Anleitung – zum Veröffentlichen wird dennoch benötigt:
- Das mote-cli-Paket oder ein Quell-Build, mit expliziter Authentifizierungskonfiguration oder einem gültigen Mote-OAuth-Login (siehe CLI-Referenz und Authentifizierung). Selbst gehostete Benutzer sollten ihre beabsichtigte Instanzkonfiguration beibehalten, oder
- Ein verbundener Mote-MCP-Server (siehe MCP-Leitfaden)
Nur der lokale Server macht publish_markdown_file verfügbar. Authentifizierungsfehler müssen dem Benutzer gemeldet werden; die Fähigkeit erstellt keine Anmeldeinformationen, initiiert keinen Browser-Login ohne Autorisierung, liest keinen Schlüsselbund eines anderen Clients oder wechselt zu einem alten Token. Explizite Anfragen nach Login-Unterstützung können im autorisierten Umfang des Benutzers behandelt werden. Wiederholen Sie keine Veröffentlichung nach einem Timeout oder unbekanntem Ergebnis, ohne zu klären, ob sie erfolgreich war.