playbooks

home / skills / artwist-polyakov / polyakov-claude-skills / agent-deck

agent-deck skill

/plugins/agent-deck/skills/agent-deck

This skill manages AI agent sessions via the agent-deck CLI, enabling launching, monitoring, and retrieving results from sub-agents.

npx playbooks add skill artwist-polyakov/polyakov-claude-skills --skill agent-deck

Review the files below or copy the command above to add this skill to your agents.

Files (9)
SKILL.md
5.4 KB
---
name: agent-deck
description: |
  Управление сессиями AI агентов через agent-deck CLI.
  Триггеры (RU): "запусти агента", "запусти саб-агента", "создай сессию",
  "проверь сессию", "проверь статус", "покажи вывод агента", "что агент ответил".
  Triggers (EN): "launch sub-agent", "create sub-agent", "start session",
  "check session", "show agent output".
---

# Agent Deck CLI

Менеджер терминальных сессий для AI агентов. Позволяет запускать, контролировать и получать результаты от дочерних Claude сессий.

## Запуск суб-агента

**Триггеры:** "запусти агента", "запусти саб-агента", "launch sub-agent"

### Простой запуск (CLI команды)

```bash
# Создать сессию
agent-deck add -t "Название" -c claude /path/to/workdir

# Создать как дочернюю сессию текущего агента
agent-deck add -t "Название" --parent "Родитель" -c claude /path/to/workdir

# Запустить
agent-deck session start "Название"

# Отправить задачу
agent-deck session send "Название" "Твоя задача..."
```

### Автоматический запуск (скрипт)

```bash
scripts/launch-subagent.sh "Название" "Промпт" [--mcp exa] [--wait]
```

Скрипт автоматически:
- Определяет текущую сессию и профиль
- Создаёт дочернюю сессию
- Ждёт инициализации Claude
- Отправляет промпт

### Режимы получения результата

| Режим | Команда | Когда использовать |
|-------|---------|-------------------|
| **Fire & forget** | (без --wait) | По умолчанию. Скажи: "Спроси меня когда будет готово" |
| **On-demand** | `agent-deck session output "Название"` | Когда пользователь спрашивает |
| **Blocking** | `--wait` | Нужен немедленный результат |

---

## Проверка статуса

**Триггеры:** "проверь сессию", "проверь статус", "check session"

```bash
agent-deck status                      # Все сессии (сводка)
agent-deck session show "Название"     # Детали конкретной сессии
agent-deck session show -json "Название"  # JSON формат
agent-deck session current             # Текущая сессия (в которой работаем)
agent-deck session current --json      # Текущая сессия в JSON
```

**Статусы:**
- `●` работает (running)
- `◐` ждёт ввода (waiting)
- `○` простаивает (idle)
- `✕` ошибка (error)

---

## Получение результата

**Триггеры:** "покажи вывод агента", "что агент ответил", "show agent output"

```bash
agent-deck session output "Название"
```

---

## MCP подключение

```bash
agent-deck mcp list                        # Доступные MCP серверы
agent-deck mcp attach "Название" exa       # Подключить MCP к сессии
agent-deck session restart "Название"      # ОБЯЗАТЕЛЬНО после подключения!
```

### Рекомендуемые MCP

| Задача | MCP серверы |
|--------|-------------|
| Веб-поиск | `exa`, `firecrawl` |
| Документация кода | `context7` |
| Сложные рассуждения | `sequential-thinking` |

---

## Управление сессиями

```bash
# Жизненный цикл
agent-deck session start "Название"
agent-deck session stop "Название"
agent-deck session restart "Название"

# Список всех сессий
agent-deck ls
agent-deck ls -json

# Удалить сессию
agent-deck rm "Название"
```

---

## Важные правила

1. **Флаги перед аргументами:** `session show -json name` (не `session show name -json`)
2. **После mcp attach** обязательно `session restart` для применения изменений
3. **Избегать polling** результатов из других агентов — это может мешать целевой сессии
4. **Идентификация сессии:** можно использовать название, ID (≥6 символов) или путь

---

## Примеры использования

### Запуск исследовательского агента

```bash
# Создать агента для веб-исследования
agent-deck add -t "Researcher" -c claude --mcp exa /tmp/research
agent-deck session start "Researcher"
agent-deck session send "Researcher" "Найди информацию о последних трендах в AI"
```

### Проверка готовности

```bash
# Проверить статус
agent-deck session show "Researcher"

# Если статус ◐ (waiting) — агент закончил, получить результат:
agent-deck session output "Researcher"
```

Overview

This skill manages terminal sessions for AI agents via the agent-deck CLI. It lets you create, start, monitor, and retrieve outputs from child Claude sessions and attach MCP tools. Built for command-line workflows, it supports both interactive and scripted automation.

How this skill works

The skill issues agent-deck CLI commands to create sessions, start and stop them, send prompts, and fetch outputs. It can spawn child agents, attach MCP servers for extended capabilities, and query session status in human or JSON formats. Blocking (--wait), fire-and-forget, and on-demand output modes are supported to fit different workflow needs.

When to use it

  • Start a dedicated Claude sub-agent to run a focused task or subprocess.
  • Create a child session from the current agent for isolation of work or tools.
  • Attach an MCP (web search, docs, reasoning) to sessions that need external capabilities.
  • Check session health, status, or details before sending more work.
  • Retrieve agent responses on-demand or block until a result is ready.

Best practices

  • Pass flags before positional args (e.g., session show -json name).
  • Restart a session after attaching or changing an MCP (agent-deck session restart).
  • Use meaningful session names or short IDs (≥6 chars) for reliable identification.
  • Prefer --wait for immediate results and fire-and-forget for background tasks.
  • Avoid polling another agent’s session output frequently — it can interfere with the target session.

Example use cases

  • Create and start a Researcher Claude: add a session, start it, then send a web-research prompt.
  • Launch a short-lived worker via scripts/launch-subagent.sh to run a prompt and exit (use --wait for blocking).
  • Attach MCP exa or firecrawl for web search, then restart the session to enable retrieval of live results.
  • Query all sessions or inspect a specific session in JSON for automation or monitoring.
  • Fetch an agent’s produced answer later with agent-deck session output "Name" when using fire-and-forget mode.

FAQ

How do I get immediate results from a sub-agent?

Start the session with --wait or use the launch script with the --wait option to block until the agent returns a result.

What statuses will I see and what do they mean?

● running, ◐ waiting (expects input or finished), ○ idle, ✕ error. Use session show to get details.

What must I do after attaching an MCP?

Run agent-deck session restart "Name" to apply the MCP to the session; otherwise the attachment won’t take effect.