Smithery CLI Skill

Der Smithery CLI Skill ist ein von Smithery und Arcade AI entwickelter Steuerungs-Skill für autonome KI-Agenten. Er vermittelt Sprachmodellen wie Claude Code, Codex oder Cursor die genauen Abläufe und Syntaxregeln, um über die globale Kommandozeile nach neuen MCP-Servern zu suchen, Server-Endpunkte zu registrieren, Werkzeuge hierarchisch zu inspizieren und Aufrufe direkt auszuführen. Das offizielle Quellcode-Repository liegt unter github.com/arcadeai-labs/smithery-cli (vormals smithery-ai/cli), der Skill selbst ist im Repository unter skills/smithery-ai-cli/SKILL.md definiert.

Was der Skill einem Agenten beibringt

Viele KI-Agenten kennen das Model Context Protocol abstrakt, wissen jedoch nicht, wie sie während einer laufenden Arbeitsaufgabe eigenständig neue Werkzeuge im System bereitstellen oder remote ansprechen. Dieser Skill schließt genau diese Wissenslücke. Sobald eine Nutzeranfrage eine externe Integration erfordert, beispielsweise Zugriff auf GitHub-Issues, Jira-Tickets, PostgreSQL-Datenbanken, Notizen oder Cloud-Monitoring, aktiviert der Agent den Skill und führt mehrere strukturierte Schritte durch.

Zunächst sucht der Agent über den Befehl smithery mcp search im Smithery-Ökosystem nach qualifizierten Server-Namen oder URLs für den gewünschten Dienst. Anschließend registriert er den gefundenen Server über smithery mcp add unter einer prägnanten lokalen Kennung.

Für die gezielte Werkzeugauswahl nutzt der Agent smithery tool list. Dieser Befehl zeigt hierarchisch gegliederte Gruppen an, sodass der Agent gezielt in Unterbereiche wie github issues vordringen kann, statt hunderte Definitionen auf einmal ins Kontextfenster zu laden. Vor der tatsächlichen Ausführung liest smithery tool get die exakte Schema-Struktur für Eingabeparameter aus, was Fehlaufrufe und Ratenlimit-Verluste verhindert. Schließlich führt smithery tool call das Werkzeug mit validierten Nutzdaten über die Befehlszeile aus.

Abgrenzung zwischen Skill, Server und CLI-Programm

Der Skill ist weder ein eigenständiger MCP-Server noch enthält er die eigentliche Programmlogik der CLI. Er stellt eine handlungsleitende Wissensbasis dar. Zur praktischen Ausführung muss das CLI-Programm smithery über den Paketmanager npm global installiert sein. Für interaktive Authentifizierungen bei Diensten leitet der Skill den Agenten an, den Nutzer zur Bestätigung über den Browser aufzufordern, anstatt Passwörter im Terminal abzufragen.

Sicherheit, Berechtigungen und Least Privilege

Weil der Agent über die CLI Werkzeuge anbinden und ausführen kann, die möglicherweise schreibenden Zugriff auf externe Dienste wie Repositories oder Datenbanken ausüben, betont der Skill strikte Sicherheitsregeln. Jeder schreibende Befehl erfordert vorab die menschliche Freigabe oder eine bewusste Eingrenzung. Die Smithery-Authentifizierung speichert Session-Tokens lokal. Der Agent wird angewiesen, Tokens und Anmeldedaten niemals in Logdateien, Prompts oder Versionskontrollen auszugeben.

Lizenz und Einordnung im Katalog

Das zugrundeliegende CLI-Repository wird unter der GNU Affero General Public License Version 3 (AGPL-3.0) bereitgestellt. Am 09.09.2026 wies das Repository 833 Sterne auf GitHub auf. Diese Metrik gilt für das gesamte CLI-Repository und nicht isoliert für den Skill-Ordner. Die Nutzung der CLI und des Skills ist quelloffen und lizenzkostenfrei. Für bestimmte über Smithery gehostete Remote-Endpunkte können separate Konditionen der jeweiligen Anbieter anfallen, weshalb dieser Katalogeintrag keine konkreten Preise nennt.