artwist-polyakov/polyakov-claude-skills

Agent Deck CLI

Gestor de sesiones terminales para agentes de IA. Permite lanzar, controlar y obtener resultados de sesiones secundarias de Claude.

Lanzar sub-agente

Disparadores: "lanzar agente", "lanzar sub-agente", "launch sub-agent"

Lanzamiento simple (comandos CLI)

# Crear sesión
agent-deck add -t "Nombre" -c claude /ruta/al/directorio

# Crear como sesión hija del agente actual
agent-deck add -t "Nombre" --parent "Padre" -c claude /ruta/al/directorio

# Iniciar
agent-deck session start "Nombre"

# Enviar tarea
agent-deck session send "Nombre" "Tu tarea..."

Lanzamiento automático (script)

scripts/launch-subagent.sh "Nombre" "Prompt" [--mcp exa] [--wait]

El script automáticamente:

• Determina la sesión y perfil actual
• Crea una sesión hija
• Espera la inicialización de Claude
• Envía el prompt

Modos de obtención de resultado

Modo	Comando	Cuándo usarlo
Fire & forget	(sin --wait)	Por defecto. Di: "Pregúntame cuando esté listo"
On-demand	agent-deck session output "Nombre"	Cuando el usuario pregunta
Blocking	--wait	Se necesita resultado inmediato

---

Verificar estado

Disparadores: "verificar sesión", "comprobar estado", "check session"

agent-deck status                      # Todas las sesiones (resumen)
agent-deck session show "Nombre"       # Detalles de una sesión específica
agent-deck session show -json "Nombre" # Formato JSON
agent-deck session current             # Sesión actual
agent-deck session current --json      # Sesión actual en JSON

Estados:

• ● en ejecución (running)
• ◐ esperando entrada (waiting)
• ○ inactivo (idle)
• ✕ error (error)

---

Obtener resultado

Disparadores: "mostrar salida del agente", "qué respondió el agente", "show agent output"

agent-deck session output "Nombre"

---

Conexión MCP

agent-deck mcp list                        # Servidores MCP disponibles
agent-deck mcp attach "Nombre" exa         # Conectar MCP a la sesión
agent-deck session restart "Nombre"        # ¡OBLIGATORIO después de conectar!

MCP recomendados

Tarea	Servidores MCP
Búsqueda web	exa, firecrawl
Documentación de código	context7
Razonamiento complejo	sequential-thinking

---

Gestión de sesiones

# Ciclo de vida
agent-deck session start "Nombre"
agent-deck session stop "Nombre"
agent-deck session restart "Nombre"

# Listar todas las sesiones
agent-deck ls
agent-deck ls -json

# Eliminar sesión
agent-deck rm "Nombre"

---

Reglas importantes

1. Banderas antes de argumentos: session show -json name (no session show name -json)
2. Después de mcp attach es obligatorio session restart para aplicar cambios
3. Evitar polling de resultados de otros agentes — puede interferir con la sesión objetivo
4. Identificación de sesión: se puede usar el nombre, ID (≥6 caracteres) o ruta

---

Ejemplos de uso

Lanzar agente de investigación

# Crear un agente para investigación web
agent-deck add -t "Researcher" -c claude --mcp exa /tmp/research
agent-deck session start "Researcher"
agent-deck session send "Researcher" "Encuentra información sobre las últimas tendencias en IA"

Verificar disponibilidad

# Verificar estado
agent-deck session show "Researcher"

# Si el estado es ◐ (waiting) — el agente terminó, obtener resultado:
agent-deck session output "Researcher"