Skills

Skills sind wiederverwendbare Anweisungspakete, die Anyy einen bestimmten Arbeitsablauf vermitteln. Ein Skill kann eine SKILL.md, Begleitdateien und einen Befehl enthalten, der in kompatiblen Chat-Oberflächen erscheint.

Skill-Quellen

Dashboard gruppiert Skills nach Herkunft:

Quelle	Bedeutung
System	Mit Anyy ausgeliefert; sichtbar, aber vom Benutzer weder umschaltbar noch entfernbar
Vom Benutzer installiert	Im verwalteten Skills-Stamm des ausgewählten Profils installiert
Vom Agenten erstellt	Verwaltete Herkunftskennzeichnung, wenn ein vorhandener Skill-Datensatz durch einen agentenfähigen Arbeitsablauf erstellt wurde

Skills gelten pro Profil. Ein anderes Profil hat einen eigenen Katalog und Aktivierungszustand.

Sie können einen Skill im Dashboard installieren oder Anyy im Gespräch bitten, eine bestimmte Quelle zu installieren. Ist skill_manage in diesem Gespräch verfügbar, schreibt es in die verwaltete Bibliothek des ausgewählten Profils. Dashboard und CLI verwenden dieselbe Bibliothek.

Über ein Gespräch installieren

Geben Sie Anyy den Pfad zu einem vertrauenswürdigen lokalen .zip-Paket, das auf seinem Host erreichbar ist, und bitten Sie es, den Skill zu installieren. Aktualisieren Sie danach Dashboard → Skills und prüfen Sie Quelle, Aktivierungszustand und Inhalt.

Auch der umgekehrte Weg funktioniert: Installieren Sie über Dashboard und bitten Sie Anyy dann, den Skill im selben Profil zu verwenden. Der nächste Prompt kann den neu geladenen Katalog entdecken und die installierte SKILL.md lesen; ein bereits laufender Prompt behält seinen aufgenommenen Kontext. Eine Erfolgsmeldung allein reicht nicht aus, wenn der Skill auf der Seite fehlt oder im Gespräch nicht gelesen werden kann.

Einen Skill prüfen

Öffnen Sie Dashboard → Skills und wählen Sie einen Skill, um Folgendes zu prüfen:

• ID, Name, Beschreibung und Geltungsbereich;
• Quellenkategorie und Verwaltungszustand;
• aktiviert oder deaktiviert;
• gerenderten Inhalt von SKILL.md;
• Dateipfad; und
• verlinkte Begleitdateien.

Lesen Sie die Anweisungen, bevor Sie einen Skill von Drittanbietern aktivieren oder installieren. Ein Skill kann beeinflussen, welche Aktionen Anyy ausführen soll und welche Werkzeuge es auswählt.

Aktivieren oder deaktivieren

Verwenden Sie den Schalter eines Nicht-System-Skills. Das Deaktivieren entfernt ihn aus der normalen Auflösung, ohne seine Dateien zu löschen. Aktivieren Sie ihn erneut, wenn er wieder verfügbar sein soll.

Laden Sie den Katalog nach Dateiänderungen außerhalb von Anyy neu. Der nächste Prompt verwendet den aktualisierten Katalog; ein bereits aufgenommener Prompt behält seine Anweisungen. Prüfen Sie den Aktivierungszustand gesondert: Das Ersetzen eines deaktivierten Skills aktiviert ihn nicht automatisch.

Aus dem Dashboard installieren

Wählen Sie Skill installieren und laden Sie eine lokale .zip mit genau einem Skill hoch: entweder eine SKILL.md auf oberster Ebene mit Begleitdateien oder ein einzelnes Skill-Verzeichnis.

Die vollständige Upload-Anfrage einschließlich Multipart-Overhead muss in 10 MiB passen. Für ZIP und entpackten Inhalt gilt ebenfalls ein Limit von 10 MiB. Die Prüfung lehnt Pfadüberschreitungen, symbolische Links, Spezialdateien und Einträge außerhalb des Staging-Stamms ab. Der Name in SKILL.md darf aus höchstens 64 Kleinbuchstaben/Ziffern bestehen, die durch einzelne Bindestriche verbunden sind, etwa release-notes; er darf kein Pfad sein. Verwenden Sie diesen Namen gegebenenfalls auch für das umschließende Verzeichnis. Die Installation ersetzt einen vorhandenen verwalteten Skill mit demselben Namen.

Der residente Skills-Dienst prüft Upload-ID, SHA-256 und Ablaufzeit im ausgewählten Profil, wendet das Paket an und lädt den Katalog neu. Die Installation akzeptiert nur lokale ZIP-Pakete. GitHub-Quellen, Remote-URLs, lokale Verzeichnisse und Sammlungsinstallationen werden nicht unterstützt; historische Quellenmetadaten vorhandener Skills bleiben verfügbar.

Skills erfordern Vertrauen wie ausführbarer Code

Prüfen Sie vor der Installation Paketanweisungen, angeforderte Befehle, externe Downloads und referenzierte Dateien. Die Archivprüfung kontrolliert die Paketstruktur; ob Sie den Anweisungen vertrauen, müssen weiterhin Sie entscheiden.

Einen Skill entfernen

Wählen Sie auf der Detailseite Skill entfernen, um einen verwalteten Skill aus dem ausgewählten Profil zu entfernen und dessen Katalog neu zu laden. System-Skills lassen sich im Dashboard nicht entfernen.

CLI-Verwaltung

Die CLI installiert eine lokale ZIP-Datei, die für den Anyy-Host erreichbar ist. Sie verwendet dieselbe verwaltete Bibliothek und Archivprüfung wie Dashboard.

anyy skills list
anyy skills view weather
anyy skills install ./weather.zip
anyy skills uninstall weather
anyy skills rollback weather
anyy skills reload

Nützliche Optionen:

• --force ersetzt einen vorhandenen verwalteten Skill;
• --now fordert nach einer Offline-Änderung ein erneutes Laden durch Gateway an; residente RPC-Änderungen laden den Katalog bereits neu;
• --revision ID stellt eine bestimmte unveränderliche Revision wieder her; und
• --json liefert maschinenlesbare Ausgabe.

Ohne --revision wählt die Wiederherstellung die vorherige verwaltete Revision. Offline-Änderungen sind nur zulässig, wenn das Profil keiner residenten Anyy-Laufzeit gehört; ohne laufendes Gateway werden die Dateien beim nächsten Start erkannt. Änderungen im Gespräch laden normalerweise ebenfalls neu; verwendet skill_manage jedoch reload:false oder meldet es reload_error, laden Sie neu, bevor Sie sich auf den nächsten Katalog verlassen.

Einen Skill verwenden

Geben Sie in der TUI /skills oder im Dashboard-Chat / ein, um den aktuellen Katalog zu durchsuchen. Installierte Skills können kanonische Befehle hinzufügen. Die genaue Liste hängt von ausgewähltem Profil, Oberfläche, Plattform und Aktivierungszustand ab.

Fehlerbehebung

Problem	Lösung
Die Installation schlägt fehl	Prüfen Sie den Quellen- oder Uploadfehler und bestätigen Sie das ausgewählte Profil
Der Skill erscheint nicht im Chat	Prüfen Sie dasselbe Profil und den Aktivierungszustand sowie Fehler beim Neuladen; senden Sie dann einen neuen Prompt mit einem verfügbaren Leser read oder bash
Das ZIP wird abgelehnt	Prüfen Sie Skill-Name und Struktur mit genau einem Skill, entfernen Sie symbolische Links/Pfadausbrüche und lassen Sie innerhalb von 10 MiB Platz für Multipart-Overhead
Deinstallation oder Wiederherstellung ist blockiert	Verwenden Sie den residenten Ablauf oder stoppen Sie Anyy vor einer Offline-Änderung
Ein System-Skill lässt sich nicht umschalten	System-Skills werden durch die Anyy-Version verwaltet

Konfigurieren Sie Fähigkeiten unter Werkzeuge; ein Skill gewährt von sich aus weder Werkzeuge noch Berechtigungen.