Je coding agent instellen

agentee is ontworpen om door een coding agent te worden aangestuurd: Claude Code, Codex, Cursor, pi of iets anders dat shell-commando's kan uitvoeren en bestanden kan bewerken. Er zijn twee onderdelen om in te stellen. De skill vertelt de agent hoe te werken. De MCP-server is optioneel en geeft clients die MCP spreken dezelfde operaties als tools.

#Installeer de skill

Een skill is een SKILL.md-bestand dat de agent laadt als een taak overeenkomt met de beschrijving. De agentee-skill dekt de loop van bewerken, checken en renderen, de volgorde om een ontwerp te bouwen, de valkuilen in het bestandsformaat, hoe te plaatsen voor assemblage en test, en hoe te itereren op simulaties zonder uren aan GPU-tijd te besteden.

De snelste manier is de skills-installer, die de agents op je machine vindt en het bestand legt waar elk van ze naar kijkt:

npx skills add https://agentee.sh

Het leest het skill-register dat agentee.sh publiceert op /.well-known/agent-skills/index.json, dat de skill vermeldt met een SHA-256-digest van het bestand. npx skills add v0l/agentee installeert dezelfde skill in plaats daarvan uit de GitHub-repository.

Om handmatig te installeren, leg je het bestand in de skills-map van je agent. Voor 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

Elk releasearchief bevat ook de skill onder skills/agentee, passend bij het binary ernaast. Als je bouwt vanuit een clone, link je die map door naar je skills-map zodat de skill bijgewerkt wordt met de code.

#Voeg de MCP-server toe

Zonder MCP gebruikt de agent de CLI via zijn shell, wat overal werkt. Met MCP krijgt hij getypeerde tools, en render_item geeft het PNG rechtstreeks terug in het gesprek, zodat een model met vision naar de printplaat kijkt zonder een bestand-ronde.

agentee mcp serveert één projectmap via stdio. Wijs het naar de map die de TOML bevat.

Claude Code, vanuit de projectmap:

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 en de meeste andere clients accepteren de algemene JSON-vorm, in .cursor/mcp.json, claude_desktop_config.json of de eigen instellingen van de client:

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

De server schrijft geen TOML voor de agent. Hij leest, controleert, rendert, routeert, simuleert en schrijft het fabpakket; de agent bewerkt bestanden nog steeds met zijn eigen tools of met agentee edit in een shell. De MCP-pagina noemt alle tools.

#Geef hem de formaatreferentie

De skill is hoe te werken. De volledige referentie per sleutel is apart, zodat het alleen context kost als nodig: agentee docs toont deze, en het MCP-tool format_reference geeft deze terug. De skill vertelt de agent om de sectie te lezen voor het bestandstype dat het gaat schrijven. Dezelfde tekst staat op deze site onder Referentie, en als één bestand op /llms-full.txt.

#Schrijf een brief waar hij mee kan werken

Een agent ontwerpt een printplaat zoals een junior-ingenieur: goed als de eisen op papier staan, slecht als hij ze moet raden. Een bruikbare brief zegt:

• Wat de printplaat doet en wat eraan aansluit: connectoren, spanningen, stromen, signalen en hun snelheden.
• De fabrikant en het aantal lagen, of de kosten waarbinnen je wilt blijven. jlcpcb met een stackup van twee of vier lagen past bij de meeste eerste printplaten.
• Groottebeperkingen, montagegaten en waar connectoren moeten zitten.
• Onderdelen die je al hebt gekozen, op fabrikantonderdeelnummer. Onderdelen die de agent zelf kiest, komen in DESIGN.md met de reden.
• Wat gesimuleerd moet worden: het RF-pad, een USB-lane, de daling van een rail, een warme regelaar.

Bijvoorbeeld:

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.

Vraag om een DESIGN.md naast de bestanden. De skill vertelt de agent er één bij te houden, met de schakeling, waarom elk onderdeel is gekozen, de layoutregels die de schakeling nodig heeft en wat nog niet is geverifieerd. Het is het document dat je controleert, en het eerste dat de volgende sessie leest.

#Kijk toe hoe hij werkt

Voer agentee view uit in het project terwijl de agent werkt. Het venster laadt opnieuw in wanneer een bestand verandert, zodat je elke plaatsing en spoor ziet landen, en je de agent kunt stoppen als hij ergens naartoe gaat waar je niet naartoe wilt. In een layout kun je onderdelen verplaatsen en sporen zelf routeert; bij opslaan schrijft het de wijzigingen in hetzelfde bestand dat de agent daarna leest. Zie De viewer.

#Wat je kunt verwachten

De agent zal zwaar op de controle leunen, en dat is het punt: elke diagnostiek noemt het bestand, het item en de plek, en de meeste noemen een waarde die slaagt. Dingen die nog van jou nodig hebben:

• Onderdeelkeuze. De agent kiest aannemelijke onderdelen; jij weet welke je kunt kopen en vertrouwen. agentee parts helpt met voorraad en prijs.
• Plaatsingsintentie. Automatische plaatsing is een begin. Waar een connector op een product gaat, of welke kant een koellichaam op zit, is jouw beslissing. Verplaats die onderdelen in de viewer en vergrendel ze.
• Simulatiebudgetten. Een FDTD-run kan tientallen minuten duren. De skill vertelt de agent eerst een dry-run te doen en grof te itereren, maar zeg het in de brief als GPU-tijd belangrijk is.
• Alles wat de bestanden niet kunnen zien: mechanische pasvorm buiten de STEP-export, regelmatetests, firmware.