Configura tu agente de código

agentee está hecho para ser dirigido por un agente de código: Claude Code, Codex, Cursor, pi o cualquier otro que pueda ejecutar comandos de shell y editar archivos. Hay dos piezas que configurar. La skill le dice al agente cómo trabajar. El servidor MCP es opcional y da a los clientes que hablan MCP las mismas operaciones como herramientas.

#Instala la skill

Una skill es un archivo SKILL.md que el agente carga cuando una tarea coincide con su descripción. La skill de agentee cubre el bucle de editar, comprobar y renderizar, el orden para construir un diseño, las trampas del formato de archivo, cómo colocar para el montaje y la prueba, y cómo iterar en simulaciones sin gastar horas de GPU.

La forma más rápida es el instalador de skills, que encuentra los agentes en tu máquina y pone el archivo donde cada uno lo busca:

npx skills add https://agentee.sh

Lee el registro de skills que agentee.sh publica en /.well-known/agent-skills/index.json, que lista la skill con un resumen SHA-256 de su archivo. npx skills add v0l/agentee instala la misma skill desde el repositorio de GitHub en su lugar.

Para instalar a mano, pon el archivo en la carpeta de skills de tu agente. Para 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

Cada archivo de liberación también lleva la skill bajo skills/agentee, coincidiendo con el binario junto a ella. Si construyes desde un clon, enlaza esa carpeta en tu carpeta de skills para que la skill se actualice con el código.

#Añade el servidor MCP

Sin MCP, el agente usa la CLI a través de su shell, que funciona en todas partes. Con MCP, obtiene herramientas tipadas, y render_item devuelve el PNG directamente en la conversación, así que un modelo con visión mira la placa sin un viaje de archivo.

agentee mcp sirve un directorio de proyecto sobre stdio. Apúntalo al directorio que contiene el TOML.

Claude Code, desde el directorio del proyecto:

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

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

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

Cursor, Claude Desktop y la mayoría de otros clientes toman la forma JSON común, en .cursor/mcp.json, claude_desktop_config.json o en la configuración propia del cliente:

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

El servidor no escribe TOML para el agente. Lee, comprueba, renderiza, enruta, simula y escribe el paquete de fabricación; el agente sigue editando archivos con sus propias herramientas o con agentee edit en una terminal. La página de MCP lista todas las herramientas.

#Dale la referencia de formato

La skill es cómo trabajar. La referencia completa clave por clave es aparte, así que solo cuesta contexto cuando hace falta: agentee docs la imprime, y la herramienta MCP format_reference la devuelve. La skill le dice al agente que lea la sección del tipo de archivo que va a escribir. El mismo texto está en este sitio bajo Referencia, y como un archivo en /llms-full.txt.

#Escribe un breve con el que pueda trabajar

Un agente diseña una placa como lo haría un ingeniero junior: bien cuando los requisitos están escritos, mal cuando tiene que adivinarlos. Un breve útil dice:

• Qué hace la placa y qué se conecta a ella: conectores, voltajes, corrientes, señales y sus velocidades.
• El fabricante y el número de capas, o el coste que quieres no superar. jlcpcb con un apilamiento de dos o cuatro capas sirve para la mayoría de placas iniciales.
• Límites de tamaño, orificios de montaje y dónde deben ir los conectores.
• Componentes que ya elegiste, por número de pieza del fabricante. Los componentes que el agente elija por su cuenta deben ir en DESIGN.md con la razón.
• Qué hay que simular: la ruta de RF, un carril de USB, la caída de un riel, un regulador caliente.

Por ejemplo:

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.

Pide un DESIGN.md junto a los archivos. La skill le dice al agente que mantenga uno, con el circuito, por qué se eligió cada componente, las reglas de layout que el circuito necesita y lo que sigue sin verificar. Es el documento que tú revisas, y el que la siguiente sesión lee primero.

#Míralo trabajar

Ejecuta agentee view en el proyecto mientras el agente trabaja. La ventana se recarga cada vez que un archivo cambia, así que ves cómo aterriza cada colocación y pista, y puedes detener al agente cuando va hacia donde no quieres. En un layout puedes mover componentes y enrutear pistas tú mismo; al guardar, se escriben en el mismo archivo que el agente lee a continuación. Ver El visor.

#Qué esperar

El agente se apoyará mucho en la comprobación, y ese es el punto: cada diagnóstico nombra el archivo, el elemento y el lugar, y la mayoría nombran un valor que pasa. Cosas que siguen requiriéndote:

• Elección de componentes. El agente elige componentes plausibles; tú sabes cuáles puedes comprar y en cuáles confías. agentee parts ayuda con stock y precio.
• Intención de colocación. La colocación automática es un punto de partida. Dónde va un conector en un producto, o hacia qué lado mira un disipador, es tu decisión. Mueve esos componentes en el visor y bloquéalos.
• Presupuestos de simulación. Una ejecución FDTD puede tardar decenas de minutos. La skill le dice al agente que haga una ejecución en seco primero y que itere grueso, pero dilo en el encargo si el tiempo de GPU importa.
• Lo que los archivos no pueden ver: ajuste mecánico más allá de la exportación STEP, pruebas regulatorias, firmware.