Skill para agentes
Herdr incluye un fichero de skill reutilizable para agentes en skills/herdr/SKILL.md.
Instala ese fichero en cualquier agente de programación que admita skills reutilizables o instrucciones personalizadas. La skill enseña al agente a controlar Herdr desde dentro de un panel de Herdr.
Herdr sirve además una guía aparte en herdr.dev/agent-guide.md para otra tarea: un agente que ayuda a una persona a aprender, instalar o resolver problemas de Herdr. La skill es para un agente que maneja Herdr; la guía es para un agente que se lo explica a una persona.
Qué hace la skill
Sección titulada «Qué hace la skill»La skill le dice al agente que use la CLI herdr cuando HERDR_ENV=1 está definida. Eso significa que el agente corre dentro de un panel gestionado por Herdr y puede hablar con seguridad con el socket local.
Con la skill instalada, un agente puede:
- inspeccionar espacios de trabajo, pestañas, paneles y agentes vecinos
- dividir paneles y ejecutar comandos sin robar el foco
- leer la salida de los paneles y los registros recientes
- esperar a servidores, pruebas o a que termine otro agente
- arrancar agentes ayudantes en paneles hermanos
La skill es un fichero de instrucciones en Markdown para agentes. Si ya tienes Herdr instalado, ejecuta herdr --skill para imprimir la copia incluida en ese binario, que coincide con su versión.
Instalarla
Sección titulada «Instalarla»Instala la skill con npx skills:
npx skills add herdrdev/herdr --skill herdr -gSi la instalaste cuando vivía en la raíz del repositorio, vuelve a ejecutar una vez este comando en vez de skills update. El comando sustituye la copia antigua, demasiado grande, y registra la ubicación nueva.
El flag -g la instala globalmente para los agentes compatibles. Omite -g para instalarla solo en el proyecto actual.
Usa la copia del repositorio como respaldo manual y fuente de verdad:
https://github.com/herdrdev/herdr/blob/master/skills/herdr/SKILL.mdEn los agentes con sistema de skills, instala ese fichero como una skill llamada herdr. En los agentes sin sistema de skills, pega el fichero en las instrucciones de proyecto o de usuario del agente.
Después de instalarla, arranca el agente dentro de Herdr:
herdrclaudeO usa cualquier otro agente de programación en un panel de Herdr, para que el proceso del agente tenga HERDR_ENV=1.
Regla de seguridad
Sección titulada «Regla de seguridad»La skill empieza con una única barrera: si HERDR_ENV=1 no está definida, el agente debe parar y decir que no está corriendo dentro de un panel gestionado por Herdr.
Así se evita que un agente fuera de Herdr intente controlar una sesión que no es suya.
Referencia para el agente
Sección titulada «Referencia para el agente»La guía completa de comandos está en el propio fichero de la skill. Cubre los IDs de panel, pane split, pane run, pane read, pane wait-output, agent wait, los comandos de espacio de trabajo y pestaña, y recetas de coordinación.
Lee el fichero original aquí: