Zum Inhalt springen
weside.aiweside docs

Skills SDK

Eine Skill ist ein Package, das deinem Companion etwas Neues beibringt: zusätzlicher Context, ein Set von Tools, die er nutzen darf, optionale Sub-Agents und Hooks, die nach Plan oder Event ausgelöst werden. Skills sind die Art, wie das Platform-Verhalten wächst, ohne die Kern-Identität des Companions zu ändern.

Was es ist

Abschnitt betitelt „Was es ist“

Jede Skill wird durch ein Manifest beschrieben — ein JSON-Dokument, das gegen ein fixes Schema validiert wird. Das Manifest ist der Vertrag; der schwere Content (Instruktionen, Reference-Doku) lebt in Dateien, auf die das Manifest hinweist, die nur bei Bedarf geladen werden. Diese Schichtung hält eine untätige Skill günstig (≈50 Token Metadaten) und zahlt nur für die Details, wenn die Skill tatsächlich genutzt wird.

Ein Manifest erklärt:

  • name, version, description, author — Identität. name ist lowercase-hyphenated, version ist semver (1.0.0).
  • context — ob es eine SKILL.md (die How-to, ~500 Token) und eine reference.md (tiefes Detail, ~2000 Token) gibt.
  • tools — Tools, die die Skill bindet, jeweils core (ein Built-in Companion-Tool) oder composio (eine externe Action), und ob es required ist.
  • agents — optionale Sub-Agents, jeweils mit eigenem Prompt und einer Whitelist von Tools, die er aufrufen darf.
  • hooks — wenn die Skill von selbst handelt: on_schedule (Cron), on_event, on_before_model, on_after_model oder on_agent_complete, jedes mit einer config und einer action (send a message, call an agent, oder take a silent turn).

Warum es für dich wichtig ist

Abschnitt betitelt „Warum es für dich wichtig ist“

Eine Skill ist die Einheit für wiederverwendbare Companion-Capability. Das Manifest zu verstehen zeigt dir genau, was eine Skill anfassen kann — welche Tools sie bekommt, wann sie unaufgefordert läuft — bevor du sie installierst, und zeigt dir die Form, auf die du hinbauen würdest, wenn du deine eigene authorst.

Wie du sie nutzt

Abschnitt betitelt „Wie du sie nutzt“

Heute ist die Developer-Oberfläche Installation und Konfiguration, freigelegt über die REST API unter /api/v1/companions/{id}/skills:

Terminal window
# Liste Skills auf, die auf der Platform veröffentlicht sind
curl https://api.weside.ai/api/v1/companions/available \
  -H "Authorization: Bearer $SUPABASE_ACCESS_TOKEN"


# Installiere eine auf einem Companion
curl -X POST https://api.weside.ai/api/v1/companions/{companion_id}/skills \
  -H "Authorization: Bearer $SUPABASE_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"skill_definition_id": 42}'

Du kannst auch installierte Skills auflisten, die Konfiguration einer Skill updaten oder sie an/aus schalten, und sie deinstallieren — dieselben Operationen, die die App’s Skill-View antreibt.

Limits & Grenzfälle

Abschnitt betitelt „Limits & Grenzfälle“
  • Authoring ist Manifest-First, noch nicht Self-Serve. Das oben beschriebene Schema ist real und stabil, aber ein öffentliches “veröffentliche deine eigene Skill” SDK und ein Marketplace landen noch — die heute veröffentlichten Skills sind auf der Platform vorgelagert. Baue gegen die Manifest-Form; der Publishing-Pfad ist, wohin das läuft.
  • Tools müssen bereits existieren. Ein Manifest kann nur einen core Tool binden, den die Platform freilegt, oder eine composio Action, die du connected hast — es kann keinen Brand-neuen Tool-Code definieren.
  • Hooks sind gated. Scheduled und Event Hooks laufen unter den Proaktivitäts- und Anti-Spam-Regeln des Companions; eine Skill kann sie nicht umgehen, um dich zu spammen.
  • Skills sind pro-Companion. Die Installation auf einem Companion beeinflusst einen anderen nicht.

Wo geht es weiter

Abschnitt betitelt „Wo geht es weiter“