Skill-system

Ein Skill ist ein Fähigkeitspaket für den Agenten: ein Verzeichnis, dessen Kern eine SKILL.md ist und das Bedienungsanleitungen, Skripte und Referenzmaterial enthält. Der Agent liest diese Inhalte bei der Ausführung einer Aufgabe bei Bedarf ein und kann dann etwas tun, was er ursprünglich nicht konnte, etwa ein Word-Dokument mit Inhaltsverzeichnis und Kopfzeile erstellen.

Was ist ein Skill

Jeder Skill ist ein Verzeichnis, das mindestens eine SKILL.md enthält: Im Frontmatter stehen name und description, der Fließtext ist die Bedienungsanleitung für den Agenten. Das Verzeichnis kann zusätzlich Anhänge (Skripte, Referenzdokumente, Konfigurationsvorlagen) enthalten sowie Abhängigkeiten und MCP-Server deklarieren.

---
name: weekly-report-style
description: 生成周报 Excel 时统一使用团队的配色与表头规范
---

# 使用说明

正文写给 Agent 看：什么时候用这个技能、
按什么步骤做、附带的脚本和参考文件怎么用。

Skills nutzen eine progressive Offenlegung: Der Agent sieht normalerweise nur den Namen und die Beschreibung jedes Skills und liest erst dann den vollständigen Fließtext und die Anhänge ein, wenn er entscheidet, dass ein Skill für die aktuelle Aufgabe nützlich ist. So werden selbst bei vielen installierten Skills nicht sämtliche Inhalte in jede Konversation gepackt.

Systemskills und von Nutzern installierte Skills

Die plattformseitig vorinstallierten allgemeinen Systemskills gliedern sich in zwei Hauptkategorien: Office-Dokumentenerstellung (docx / xlsx / pptx / pdf) und Entwicklungs-Skills (Frontend, Full-Stack, iOS, Android, Flutter, React Native usw.). Die vollständige Liste finden Sie in der Konsole auf der Seite „Skill-Verwaltung“; wenn Sie einen Skill öffnen, sehen Sie seine Version, seine Anhänge und den vollständigen Text der SKILL.md.

Office-dokumentenerstellung

Mit dieser Gruppe von Systemskills erzeugen Agenten-Schritte direkt Office-Dokumentdateien statt nur Markdown-Text:

Typische Verwendung: Ein Agenten-Schritt in einem Tagesbericht-Workflow erstellt mit dem xlsx-Skill eine formatierte Wochenberichtstabelle, die zusammen mit den Ausführungsartefakten heruntergeladen oder direkt an Slack / per E-Mail zugestellt wird. Artefakte lassen sich außerdem als öffentlicher Link veröffentlichen, sieheÖffentliche Produktfreigabe.

Skill-marktplatz: Installation und Versionen

Die Seite „ClawHub-Skill-Marktplatz“ in der Konsole ist mit der ClawHub-Registry verbunden. Suchen Sie nach Stichwörtern, sehen Sie Version, Autor, Download-Zahl und Aktualisierungszeitpunkt jedes Skills und installieren Sie ihn mit einem Klick für Ihr Konto.

# 搜索市场
curl "https://braidrun.com/api/skills/market/search?query=testing&limit=10" \
  -H "Authorization: Bearer <token>"

# 安装（安装状态只记在你自己的账号下）
curl -X POST https://braidrun.com/api/skills/market/<slug>/install \
  -H "Authorization: Bearer <token>"

# 升级到最新版本
curl -X POST https://braidrun.com/api/skills/market/<slug>/upgrade \
  -H "Authorization: Bearer <token>"

• Skills haben eine Versionsnummer. Klicken Sie bei installierten Skills auf der Seite „Skill-Verwaltung“ auf „Nach Updates suchen“; bei einem Upgrade wird die neueste Version erneut heruntergeladen
• Nur aus dem Marktplatz installierte Skills durchlaufen den Upgrade-Prozess; per ZIP importierte Skills haben keine Upgrade-Quelle, importieren Sie sie einfach erneut
• Die Deinstallation entfernt nur die Installation in Ihrem eigenen Konto und wirkt sich nicht auf andere Nutzer aus, die denselben Skill installiert haben
• Sie können auch selbst geschriebene Skills direkt per ZIP-Upload importieren: Das Paket muss eine SKILL.md mit gültigen Feldern name und description enthalten; die Gesamtgröße nach dem Entpacken darf 100 MB nicht überschreiten

Pro Nutzer aktivieren / deaktivieren

Auf der Seite „Skill-Verwaltung“ hat jeder Skill einen eigenen Schalter. Der Aktivierungs-/Deaktivierungsstatus wird unter Ihrem eigenen Konto gespeichert: Wenn Sie einen Systemskill deaktivieren, ist er für Ihre Agenten nicht mehr sichtbar, andere Nutzer sind davon nicht betroffen. Von anderen Nutzern privat installierte Skills können Sie weder sehen noch werden sie geladen.

Agenten-geltungsbereich: einschränken, welche Skills ein bestimmter Agent verwenden darf

Über den kontoweiten Schalter hinaus können Sie in der Agenten-Konfiguration für einen einzelnen Agenten einen engeren Skill-Bereich festlegen. Gängige Felder:

• Schalter für das Skills-Subsystem — nach dem Abschalten verwendet dieser Agent überhaupt keine Skills
• Whitelist-Modus — nach der Aktivierung werden von diesem Agenten nur Skills auf der Whitelist erkannt; integrierte Skills werden automatisch der Whitelist hinzugefügt
• Sperrliste — eine Blacklist, die auch bei ausgeschaltetem Whitelist-Modus wirksam bleibt
• Maximale Skill-Anzahl pro Anfrage — begrenzt die Anzahl der pro Anfrage injizierten Skills
• Automatisches Suchen und Herunterladen — standardmäßig ausgeschaltet; nach der Aktivierung sucht und lädt der Agent bei fehlenden lokalen Fähigkeiten automatisch neue Skills von ClawHub. Dabei kommt es zu externen Downloads, daher in Unternehmensumgebungen mit Vorsicht zu verwenden

Bei der Ausführung führt die Plattform die Agenten-Konfiguration und Ihren Status auf Nutzerebene zum letztlich wirksamen Skill-Bereich zusammen: Ein von Ihnen auf der Seite „Skill-Verwaltung“ deaktivierter Skill steht keinem der Agenten in dieser Ausführung zur Verfügung.

Laufzeitkonfiguration

Manche Skills funktionieren erst, wenn zuvor Parameter oder Anmeldedaten eingegeben wurden, etwa ein API token eines Drittdienstes. Skills mit einer Konfigurationsvorlage zeigen auf der Karte „Konfiguriert / Zu konfigurieren“ an; klicken Sie auf „Skill konfigurieren“ und füllen Sie die Felder aus.

• Sensible Felder (token, Passwörter, private Schlüssel usw.) werden nach dem Speichern maskiert angezeigt und nicht im Klartext ausgegeben; wird das Feld maskiert übermittelt, bleibt der alte Wert erhalten
• Selbst installierte Skills können Sie selbst konfigurieren; die Laufzeitkonfiguration von Systemskills kann nur ein Administrator ändern

Gängige Endpunkte

Verwandte Seiten

• Detaillierte Erläuterung der Agentenkonfiguration
• Integrierte Modulbibliothek
• Öffentliche Produktfreigabe