invoke-agent
Busca en el workspace actual de herdr un agente ya despierto para el rol pedido (PM, BA, UX, ARCH, LEAD, TESTER, DEV); si no hay ninguno, crea un pane nuevo, levanta un agente en él y le carga ese rol. Use when the user runs /invoke-agent, asks to hand off work to another agent/role, spawn a new agent, or bring a PM/BA/UX/Architect/Lead/Tester/Developer into a herdr session.
How do I install this agent skill?
npx skills add https://github.com/adminoryslabs/armory --skill invoke-agentIs this agent skill safe to install?
- Gen Agent Trust Hubwarn
This skill automates agent lifecycle management and orchestration within the Herdr platform using CLI commands. The primary security concerns involve the installation of external skills from unverified third-party repositories and the risk of indirect prompt injection in the data-sharing workflow between agents.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Invoke Agent — Invocar un rol en herdr
Goal
Conseguir que un agente con el rol pedido esté disponible y con el playbook cargado, dentro del
workspace de herdr actual — reusando uno ya despierto si existe, o creando uno nuevo si no.
Para cargar un rol en la sesión donde se está ejecutando ahora mismo, sin tocar herdr, usar
init-agent en su lugar.
Roles disponibles
Los mismos que init-agent: PM, BA, UX, ARCH, LEAD, TESTER, DEV
(references/PLAYBOOK-<ROL>.md). Convención de nombre de agente en herdr: el rol en minúscula
(pm, ba, ux, arch, lead, tester, dev).
Input
Un parámetro de rol, case-insensitive. Ejemplo: /invoke-agent TESTER.
Si no se especifica, o no matchea ninguno, preguntar cuál rol invocar y esperar respuesta. No asumir un rol por defecto.
Workflow
- Determinar el workspace actual. Leer la variable de entorno
HERDR_WORKSPACE_ID(si no está disponible, resolverla conherdr pane get $HERDR_PANE_ID). - Listar los panes del workspace actual:
herdr pane list --workspace <workspace_id>. - Listar los agentes vivos:
herdr agent list. - Cruzar ambos listados. Buscar un agente cuyo
pane_idesté entre los panes del workspace actual y cuyo nombre coincida con la convención del rol pedido. Un agente despierto con el rol correcto pero en otro workspace no cuenta — se ignora.- Si existe en el workspace actual → es el destinatario. Ir al paso 6.
- Si no existe → ir al paso 5.
- Crear un agente nuevo en el workspace actual:
- Si el nombre del rol ya está tomado por un agente vivo en otro workspace, elegir un nombre
libre agregando un sufijo numérico (
dev-2,dev-3, ...). herdr pane split --current --direction right --focus→ capturar elpane_iddevuelto.herdr agent start <nombre-resuelto> --kind <tu-agente> --pane <pane_id>, usando el mismo tipo de agente con el que estás corriendo (claude, opencode, etc.) salvo que el usuario pida otro.
- Si el nombre del rol ya está tomado por un agente vivo en otro workspace, elegir un nombre
libre agregando un sufijo numérico (
- Entregarle el rol y el trabajo al agente (nuevo o reusado):
herdr agent prompt <target> "/init-agent <ROL>"— para que se cargue el playbook a sí mismo en lugar de pegarlo por texto.- Un segundo
herdr agent prompt <target> "<encargo concreto>"con la tarea real: dónde está el insumo, contexto mínimo del proyecto y cualquier punto abierto relevante. - Si el encargo espera un aviso de vuelta (por ejemplo, el LEAD esperando una entrega),
incluir en el encargo tu propio nombre de agente y el formato del aviso:
herdr agent prompt <tu-nombre> "ENTREGA <ROL>: ...". Tu nombre se obtiene conherdr agent list, buscando el agente cuyopane_idcoincide con$HERDR_PANE_ID.
- Confirmar al usuario, en una línea, si se reusó un agente existente o se creó uno nuevo, y su
pane_id/nombre.
Mensajes entre agentes
Los avisos entre agentes llevan un prefijo fijo, para que el receptor sepa qué hacer sin interpretar el texto. El mensaje solo señala: el contenido vive en archivos del proyecto.
| Prefijo | De → a | Cuándo |
|---|---|---|
ENTREGA <ROL> | TESTER / DEV → LEAD | Terminó su parte de la unidad de trabajo |
CONTEXTO TÉCNICO LISTO | ARCH → BA | El humano aprobó el contexto técnico de un sistema existente |
GLOSARIO: TÉRMINOS NUEVOS | BA → ARCH | Hay términos del glosario sin ubicación en el código |
GLOSARIO COMPLETO | ARCH → BA | Ubicaciones completadas |
Máximo dos vueltas por el mismo desacuerdo entre dos agentes; después decide el humano.
Notas
- Depende de que
init-agentesté instalado en el mismo entorno del agente invocado. Si no lo está, pegar el contenido completo del playbook correspondiente en el primerherdr agent prompten su lugar. - Nunca reusar un agente del rol pedido si está despierto en otro workspace, aunque esté idle.
- Si
herdr agent startfalla por nombre ya ocupado, diagnosticar conherdr agent list/herdr agent getantes de reintentar a ciegas con otro nombre. - No usar
--waitpara esperar entregas largas: un timeout no implica que el trabajo falló. Para eso existe el aviso de vuelta del paso 6.3.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/adminoryslabs/armory/invoke-agent">View invoke-agent on skillZs</a>