Configured Agent für Claude Code

Configured Agent ist die eindeutige Skill-Road-Zuordnung des Smithery-Slugs configured-agent zum offiziellen Anthropic-Pfad plugin-settings im Repository claude-code. Der Katalogname folgt der Registry-Bezeichnung, während die offizielle Primärquelle die fachliche Identität bestimmt. Anthropic beschreibt dort ein Muster, mit dem Claude-Code-Plugins projektbezogene Einstellungen und Zustand in einer Datei unter .claude speichern können. Die Datei trägt den Plugin-Namen mit dem Suffix .local.md, enthält YAML-Frontmatter für strukturierte Werte und kann darunter zusätzlichen Markdown-Kontext aufnehmen. Diese Ressource ist deshalb als Skill und nicht als eigenständiger Agent, Server oder ausführbares Plugin eingeordnet.

Zweck und fachliche Einordnung

Das Muster richtet sich an Plugin-Maintainer, Entwicklerinnen und Entwickler sowie Teams, die das Verhalten eines Plugins pro Projekt steuerbar machen wollen. Laut Anbieter können Hooks, Commands und Agents die Datei lesen und daraus erwartete Konfigurationswerte übernehmen. Ein fehlendes Dokument gilt als normaler Zustand. Ein Plugin kann dann sichere Defaults verwenden oder eine optionale Funktion überspringen. Diese Eigenschaft trennt gemeinsam ausgelieferte Plugin-Logik von lokalen Präferenzen und verhindert, dass der Zustand eines einzelnen Rechners unbemerkt zur Teamkonvention wird. Der Skill dokumentiert ein Dateimuster; er installiert keine Erweiterung und gewährt keine zusätzlichen Berechtigungen.

Aufbau und Arbeitsweise

Anthropic beschreibt YAML-Frontmatter zwischen zwei Begrenzungszeilen und einen Markdown-Teil für weitere Hinweise, Aufgabenbeschreibung oder Kontext. In der Konfiguration können beispielsweise Aktivierungsflags, Modi, Zahlenwerte, Textwerte und einfache Listen stehen. Verantwortungsvolle Implementierungen prüfen zunächst, ob die Datei existiert, lesen nur ein begrenztes Schema und validieren jeden Wert vor der Verwendung. Boolesche Werte sollten strikt verglichen werden, Zahlen benötigen nachvollziehbare Grenzen und Pfade dürfen keine unerwarteten Ziele oder Traversal enthalten. Ein erfolgreicher Lesevorgang ist noch keine fachliche Freigabe für einen Hook oder ein Skript.

Lebenszyklus und Teamgrenzen

Die Datei ist für ein einzelnes Projekt und lokale Anpassungen gedacht. Laut Anbieter soll sie nicht in Git eingecheckt werden; passende Regeln in .gitignore helfen gegen versehentliche Weitergabe. Nach einer Änderung muss Claude Code neu gestartet werden, damit Hooks die neue Konfiguration erkennen. Der Skill empfiehlt für Plugin-eigene Ressourcen die Variable CLAUDE_PLUGIN_ROOT statt hart codierter Pfade. Teams sollten Schema, Defaults, zulässige Werte, Laufzeitabhängigkeiten und Neustartverhalten im Plugin dokumentieren. Gemeinsame Standards gehören in versionierte Plugin-Dateien, nicht in lokale Zustandsdateien.

Sicherheit und Grenzen

Konfigurationsdateien sind Eingaben und können sensible oder missverständliche Inhalte enthalten. Geheimnisse, Tokens und Zugangsdaten gehören nicht in diese Datei. Vor einer Aktivierung müssen Hooks, Shell-Skripte, Netzwerkzugriffe, Schreiboperationen und Umgebungsvariablen separat geprüft werden. Das Frontmatter-Format verleiht keine Berechtigungen und beweist keine Vertrauenswürdigkeit. Ebenso ersetzt es keine zentrale Geheimnisverwaltung, keine Codeprüfung und keine Absicherung gegen Prompt-Injection. Skill Road führt den Eintrag laut Anbieterangaben als externen, verifizierten Anthropic-Skill und nennt keine konkreten Preise. Aktuelle Verfügbarkeit und Nutzungsbedingungen von Claude Code und verbundenen Diensten sind beim Anbieter zu prüfen.