Deinen Coding-Agenten einrichten

agentee ist dafür gebaut, von einem Coding-Agenten gesteuert zu werden: Claude Code, Codex, Cursor, pi oder alles andere, das Shell-Befehle ausführen und Dateien bearbeiten kann. Es gibt zwei Teile, die du einrichten musst. Der Skill sagt dem Agenten, wie er arbeitet. Der MCP-Server ist optional und gibt Clients, die MCP sprechen, dieselben Operationen als Tools.

#Skill installieren

Ein Skill ist eine SKILL.md-Datei, die der Agent lädt, wenn eine Aufgabe zu ihrer Beschreibung passt. Der agentee-Skill deckt die Schleife aus Bearbeiten, Prüfen und Rendern ab, die Reihenfolge, in der man ein Design aufbaut, die Fallstricke im Dateiformat, wie man für Bestückung und Test platziert und wie man Simulationen iteriert, ohne Stunden an GPU-Zeit zu verbrauchen.

Der schnellste Weg ist der Skills-Installer, der die Agenten auf deinem Rechner findet und die Datei an den Ort legt, an dem jeder von ihnen sucht:

npx skills add https://agentee.sh

Er liest das Skill-Register, das agentee.sh unter /.well-known/agent-skills/index.json veröffentlicht. Dort steht der Skill mit einem SHA-256-Prüfwert seiner Datei. npx skills add v0l/agentee installiert denselben Skill stattdessen aus dem GitHub-Repository.

Zum manuellen Installieren legst du die Datei in den Skills-Ordner deines Agenten. Für Claude Code:

mkdir -p ~/.claude/skills/agentee
curl -fsSL https://agentee.sh/.well-known/agent-skills/agentee/SKILL.md -o ~/.claude/skills/agentee/SKILL.md

Jedes Release-Archiv enthält außerdem den Skill unter skills/agentee, passend zum Binärprogramm daneben. Wenn du aus einem Clone baust, verlinke diesen Ordner in deinen Skills-Ordner, damit der Skill mit dem Code aktualisiert wird.

#MCP-Server hinzufügen

Ohne MCP verwendet der Agent die CLI über seine Shell, was überall funktioniert. Mit MCP bekommt er typisierte Tools, und render_item gibt das PNG direkt in das Gespräch zurück, sodass ein Modell mit Vision die Platine ohne Datei-Rundlauf ansieht.

agentee mcp dient ein Projektverzeichnis über stdio. Zeige es auf das Verzeichnis, das die TOML-Dateien enthält.

Claude Code, aus dem Projektverzeichnis:

claude mcp add agentee -- agentee mcp "$PWD"

Codex, in ~/.codex/config.toml:

[mcp_servers.agentee]
command = "agentee"
args = ["mcp", "/path/to/project"]

Cursor, Claude Desktop und die meisten anderen Clients nehmen die gängige JSON-Form an, in .cursor/mcp.json, claude_desktop_config.json oder den eigenen Einstellungen des Clients:

{
  "mcpServers": {
    "agentee": {
      "command": "agentee",
      "args": ["mcp", "/path/to/project"]
    }
  }
}

Der Server schreibt kein TOML für den Agenten. Er liest, prüft, rendert, routet, simuliert und schreibt das Fertigerpaket; der Agent bearbeitet die Dateien weiterhin mit seinen eigenen Werkzeugen oder mit agentee edit in einer Shell. Die MCP-Seite listet alle Werkzeuge.

#Gib ihm das Formatreferenzdokument

Der Skill ist die Arbeitsweise. Die vollständige Referenz, Schlüssel für Schlüssel, ist getrennt, damit sie nur Kontext kostet, wenn sie gebraucht wird: agentee docs gibt sie aus, und das MCP-Tool format_reference liefert sie zurück. Der Skill sagt dem Agenten, die Sektion für die Dateisorte zu lesen, die er gerade schreiben will. Derselbe Text steht auf dieser Seite unter Referenz und als eine Datei unter /llms-full.txt.

#Schreibe eine kurze Vorgabe, an der er arbeiten kann

Ein Agent entwirft eine Platine so wie ein Junior-Ingenieur: gut, wenn die Anforderungen schriftlich vorliegen, schlecht, wenn er sie raten muss. Eine nützliche Vorgabe nennt:

• Was die Platine tut und was an sie angeschlossen wird: Steckverbinder, Spannungen, Ströme, Signale und deren Geschwindigkeiten.
• Der Fertiger und die Schichtanzahl, oder der Kostenrahmen, den du einhalten willst. jlcpcb mit einem Zwei- oder Vierschicht-Lagenaufbau eignet sich für die meisten ersten Platinen.
• Größenlimits, Befestigungsbohrungen und wo Steckverbinder sitzen müssen.
• Bauteile, die du bereits ausgewählt hast, nach Herstellerartikelnummer. Bauteile, die der Agent selbst auswählt, gehören mit Begründung in DESIGN.md.
• Was simuliert werden muss: der RF-Weg, eine USB-Leitung, der Spannungsabfall einer Schiene, ein heißer Regler.

Zum Beispiel:

Design a 4 layer JLCPCB board, at most 40 x 30 mm, that powers a Raspberry Pi
Pico from USB-C or a 2S LiPo through an ideal diode OR, with a 3.3 V 1 A buck
for an external sensor header. Put the USB-C and the battery JST-PH on the
same short edge. Use parts JLCPCB stocks. Write DESIGN.md as you go, run a DC
drop sim of the 3.3 V rail at 1 A and a thermal sim with the buck at 0.6 W.

Bitte um eine DESIGN.md neben den Dateien. Der Skill sagt dem Agenten, eine zu führen, mit dem Schaltkreis, warum jedes Bauteil gewählt wurde, den Layout-Regeln, die der Schaltkreis braucht, und dem, was noch nicht verifiziert ist. Es ist das Dokument, das du überprüfst, und das, das die nächste Sitzung zuerst liest.

#Beobachte, wie er arbeitet

Führe agentee view im Projekt aus, während der Agent arbeitet. Das Fenster lädt neu, sobald sich eine Datei ändert, so siehst du jede Platzierung und jede Leiterbahn, und du kannst den Agenten stoppen, wenn er in eine Richtung geht, die du nicht willst. In einem Layout kannst du Bauteile selbst verschieben und Leiterbahnen routen; beim Speichern werden sie in dieselbe Datei geschrieben, die der Agent als Nächstes liest. Siehe Der Viewer.

#Was du erwarten kannst

Der Agent wird stark auf die Prüfung zurückgreifen, und das ist der Punkt: Jede Diagnose benennt die Datei, das Element und die Stelle, und die meisten nennen einen Wert, der durchgeht. Was noch von dir kommt:

• Bauteilauswahl. Der Agent wählt plausible Bauteile; du weißt, welche du kaufen und denen du vertrauen kannst. agentee parts hilft bei Lagerbestand und Preis.
• Platzierungsabsicht. Automatische Platzierung ist ein Anfang. Wo ein Steckverbinder an einem Produkt sitzt oder auf welche Seite ein Kühlkörper zeigt, entscheidest du. Verschiebe diese Bauteile im Viewer und sperr sie.
• Simulationsetats. Ein FDTD-Lauf kann mehrere Dutzend Minuten dauern. Der Skill sagt dem Agenten, zuerst einen Dry-Run zu machen und grob zu iterieren, aber sag es im Brief, wenn GPU-Zeit wichtig ist.
• Alles, was die Dateien nicht sehen: mechanische Passform jenseits des STEP-Exports, Normprüfungen, Firmware.