Puppetmaster Agent Orchestration
professorpalmer/Puppetmaster
Operates and supervises Puppetmaster, a multi-agent orchestrator, through its MCP tools or CLI, picking the right verb for edits, reviews, audits and long-running jobs.
Launches, monitors and collects results from child AI agent sessions with the agent-deck terminal session manager.
SKILL.md written in Russian; this summary is our English description.
Install Agent Deck Sessions
$ npx skills add artwist-polyakov/polyakov-claude-skills --skill agent-deck -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install artwist-polyakov/polyakov-claude-skills agent-deck --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/artwist-polyakov/polyakov-claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/agent-deck/skills/agent-deck .claude/skills/agent-deck && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "agent-deck" agent skill from https://github.com/artwist-polyakov/polyakov-claude-skills/tree/main/plugins/agent-deck/skills/agent-deck into .claude/skills/agent-deck/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-deck", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/artwist-polyakov/polyakov-claude-skills/tree/main/plugins/agent-deck/skills/agent-deckType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add artwist-polyakov/polyakov-claude-skills --skill agent-deck -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install artwist-polyakov/polyakov-claude-skills agent-deck --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/artwist-polyakov/polyakov-claude-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugins/agent-deck/skills/agent-deck .agents/skills/agent-deck && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "agent-deck" agent skill from https://github.com/artwist-polyakov/polyakov-claude-skills/tree/main/plugins/agent-deck/skills/agent-deck into .agents/skills/agent-deck/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-deck", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add artwist-polyakov/polyakov-claude-skills --skill agent-deck -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install artwist-polyakov/polyakov-claude-skills agent-deck --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/artwist-polyakov/polyakov-claude-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugins/agent-deck/skills/agent-deck .cursor/skills/agent-deck && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "agent-deck" agent skill from https://github.com/artwist-polyakov/polyakov-claude-skills/tree/main/plugins/agent-deck/skills/agent-deck into .cursor/skills/agent-deck/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-deck", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/artwist-polyakov/polyakov-claude-skills.git --path plugins/agent-deck/skills/agent-deck--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add artwist-polyakov/polyakov-claude-skills --skill agent-deck -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install artwist-polyakov/polyakov-claude-skills agent-deck --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/artwist-polyakov/polyakov-claude-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugins/agent-deck/skills/agent-deck .gemini/skills/agent-deck && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "agent-deck" agent skill from https://github.com/artwist-polyakov/polyakov-claude-skills/tree/main/plugins/agent-deck/skills/agent-deck into .gemini/skills/agent-deck/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-deck", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install artwist-polyakov/polyakov-claude-skills agent-deckInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add artwist-polyakov/polyakov-claude-skills --skill agent-deck -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/artwist-polyakov/polyakov-claude-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugins/agent-deck/skills/agent-deck .github/skills/agent-deck && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "agent-deck" agent skill from https://github.com/artwist-polyakov/polyakov-claude-skills/tree/main/plugins/agent-deck/skills/agent-deck into .github/skills/agent-deck/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-deck", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add artwist-polyakov/polyakov-claude-skills --skill agent-deck -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install artwist-polyakov/polyakov-claude-skills agent-deck --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/artwist-polyakov/polyakov-claude-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugins/agent-deck/skills/agent-deck .opencode/skills/agent-deck && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "agent-deck" agent skill from https://github.com/artwist-polyakov/polyakov-claude-skills/tree/main/plugins/agent-deck/skills/agent-deck into .opencode/skills/agent-deck/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-deck", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
agent-deck- GitHub stars
- 206
- Token cost
- ~965 tokens
- SKILL.md length
- 186 words
- Files
- 9 (incl. scripts, references)
- Skills in repo
- 21
- Repo updated
- First seen
- Licence
- MIT
At a glance
Launches, monitors and collects results from child AI agent sessions with the agent-deck terminal session manager.
- Works in 4 steps: Флаги перед аргументами: session show… → После mcp attach обязательно session… → Избегать polling результатов из других… → …
- Starting a sub-agent in its own session with a prompt
- SKILL.md covers Запуск суб-агента, Проверка статуса, Получение результата and MCP подключение, plus 3 more sections
- Runs Shell scripts from its folder
What it does
This skill drives agent-deck, a terminal session manager for AI agents, so a parent Claude session can launch child sessions, watch them and collect what they produce. Commands cover creating a session in a working directory, starting, stopping and restarting it, showing status for all sessions or details (also as JSON) for one, and printing a session's output on request. The skill text is in Russian.
A launch-subagent.sh script automates starting a sub-agent: it detects the current session and profile, creates the child session, waits for Claude to initialize and sends the prompt, optionally attaching an MCP server and waiting for completion. There are three ways to get a result: fire and forget by default, fetching output on demand, or blocking with --wait. MCP servers can be listed and attached to a session, which must then be restarted; suggested servers are exa and firecrawl for web search, context7 for code documentation and sequential-thinking for complex reasoning. References cover automation patterns, the CLI, config, profiles, the TUI and troubleshooting.
When your agent uses it
- Starting a sub-agent in its own session with a prompt
- Checking the status of running agent sessions
- Fetching a session's output on request
- Attaching an MCP server to a session and restarting it
Example prompts
- “Launch a sub-agent called docs-review in this repo to review the README, and tell me when it is done.”
- “Check the status of all my agent-deck sessions.”
- “Show me what the docs-review agent answered.”
- “Attach the exa MCP server to the research session and restart it.”
Requirements
- The agent-deck CLI
Workflow steps
4 steps, taken from the first numbered list in SKILL.md.
- Флаги перед аргументами: session show -json name (не session show name -json)
- После mcp attach обязательно session restart для применения изменений
- Избегать polling результатов из других агентов — это может мешать целевой сессии
- Идентификация сессии: можно использовать название, ID (≥6 символов) или путь
What it can do on your machine
Read from SKILL.md and the folder at commit b86e36d. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 1 file in scripts/ (Shell), which the agent can run.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Agent Deck Sessions loads about 965 tokens when it runs, and up to ~6.5k if it reads all its reference files. Until then it costs about 81 tokens; SKILL.md has 186 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
SKILL.md
The full file from artwist-polyakov/polyakov-claude-skills at commit b86e36d, republished under its MIT licence (© artwist-polyakov). 186 words, ~965 tokens.
Download SKILL.mdSave it as
.claude/skills/agent-deck/SKILL.md (or your agent's skills folder). This skill also uses 8 other files; get the full folder from GitHub.- 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 команды)
# Создать сессию
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 "Название" "Твоя задача..."Автоматический запуск (скрипт)
scripts/launch-subagent.sh "Название" "Промпт" [--mcp exa] [--wait]Скрипт автоматически:
- Определяет текущую сессию и профиль
- Создаёт дочернюю сессию
- Ждёт инициализации Claude
- Отправляет промпт
Режимы получения результата
| Режим | Команда | Когда использовать |
|---|---|---|
| Fire & forget | (без --wait) | По умолчанию. Скажи: "Спроси меня когда будет готово" |
| On-demand | agent-deck session output "Название" | Когда пользователь спрашивает |
| Blocking | --wait | Нужен немедленный результат |
Проверка статуса
Триггеры: "проверь сессию", "проверь статус", "check session"
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"
agent-deck session output "Название"MCP подключение
agent-deck mcp list # Доступные MCP серверы
agent-deck mcp attach "Название" exa # Подключить MCP к сессии
agent-deck session restart "Название" # ОБЯЗАТЕЛЬНО после подключения!Рекомендуемые MCP
| Задача | MCP серверы |
|---|---|
| Веб-поиск | exa, firecrawl |
| Документация кода | context7 |
| Сложные рассуждения | sequential-thinking |
Управление сессиями
# Жизненный цикл
agent-deck session start "Название"
agent-deck session stop "Название"
agent-deck session restart "Название"
# Список всех сессий
agent-deck ls
agent-deck ls -json
# Удалить сессию
agent-deck rm "Название"Важные правила
- Флаги перед аргументами:
session show -json name(неsession show name -json) - После mcp attach обязательно
session restartдля применения изменений - Избегать polling результатов из других агентов — это может мешать целевой сессии
- Идентификация сессии: можно использовать название, ID (≥6 символов) или путь
Примеры использования
Запуск исследовательского агента
# Создать агента для веб-исследования
agent-deck add -t "Researcher" -c claude --mcp exa /tmp/research
agent-deck session start "Researcher"
agent-deck session send "Researcher" "Найди информацию о последних трендах в AI"Проверка готовности
# Проверить статус
agent-deck session show "Researcher"
# Если статус ◐ (waiting) — агент закончил, получить результат:
agent-deck session output "Researcher"© artwist-polyakov, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 8 other files (scripts, references) in plugins/agent-deck/skills/agent-deck of artwist-polyakov/polyakov-claude-skills.
- SKILL.md
- references/automation-patterns.md
- references/cli-reference.md
- references/config-reference.md
- references/mcp-management.md
- references/profiles.md
- references/troubleshooting.md
- references/tui-reference.md
- scripts/launch-subagent.sh
Open the folder on GitHubat commit b86e36d
Compare with similar skills
Agent Deck Sessions next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Agent Deck Sessions this skillartwist-polyakov/polyakov-claude-skills | 206 | — | ~965 | Automated safety check: Pass | MIT | |
| Puppetmaster Agent Orchestrationprofessorpalmer/Puppetmaster | 467 | — | ~3.2k | Automated safety check: Pass | MIT | |
| Ruflo Multi-Agent Orchestrationruvnet/ruflo | 74k | 1 repos | ~975 | Automated safety check: Pass | MIT | |
| Run Wavejpicklyk/task-orchestrator | 207 | — | ~4.7k | Automated safety check: Pass | MIT | |
| Sandboxed.sh MissionsTh0rgal/sandboxed.sh | 515 | — | ~23k | Automated safety check: Notes | MIT | |
| Advanced Swarm Orchestrationruvnet/agentic-flow | 816 | 5 repos | ~5.9k | Automated safety check: Pass | None |
Similar skills
Ruflo Multi-Agent Orchestration
ruvnet/ruflo
Sets up and drives Ruflo, an npm-installed orchestration layer for multi-agent swarms, persistent memory, routing, hooks and its MCP tool catalog.
Run Wave
jpicklyk/task-orchestrator
Resolves ready MCP work items into a run plan, shows it to you, then executes it through the Workflow tool or direct subagent dispatch, with post-run verification.
Sandboxed.sh Missions
Th0rgal/sandboxed.sh
Delegates multi-step coding or research tasks to isolated sandboxed.sh container missions through its MCP tools, each with a chosen workspace, agent profile and prompt.
Advanced Swarm Orchestration
ruvnet/agentic-flow
Patterns for running multi-agent swarms on research, development and testing work, with four topologies and a four-phase research swarm built on claude-flow MCP tools.
Codex with ChatGPT Planning Loop
XiaoDuoYa/codex-with-chatgpt
Uses ChatGPT in the browser as the planning and review brain for a Codex session, with Codex keeping all execution and ChatGPT reading the workspace through a bridge.
More from artwist-polyakov/polyakov-claude-skills
All 21 skills in this repoCrawl4AI SEO Site Crawler
artwist-polyakov/polyakov-claude-skills
Crawls a site with Crawl4AI to audit titles, meta tags, H1s, canonicals, navigation and internal links, and to compare landing pages and competitor sites.
GitHub Pages Publisher
artwist-polyakov/polyakov-claude-skills
Publishes already-built static pages to a GitHub Pages repo under a year, year-month and slug folder layout, optimizes large images and returns the public URL.
Perplexity Search and Research
artwist-polyakov/polyakov-claude-skills
Shell scripts for web search and research through the Perplexity API: raw results, cited answers, background deep research and page fetching, with results cached on disk.
Sourcecraft Publisher
artwist-polyakov/polyakov-claude-skills
Publish static page artifacts to SourceCraft Sites (Yandex infrastructure, works in Russia), with advisory image optimization and an original-image path.
X/Twitter Research via Grok
artwist-polyakov/polyakov-claude-skills
Searches X/Twitter through the xAI Grok API to build digests, trend reports and thread analysis, meant to surface post ideas for a Telegram channel.
Yandex Metrika
artwist-polyakov/polyakov-claude-skills
Яндекс Метрика: детализация трафика по источникам и UTM-меткам, отчёты по конверсиям и поисковым системам, API-сегменты и доступы к счётчикам.
Related
Works with
Categories
Questions about Agent Deck Sessions
What does Agent Deck Sessions do?
Launches, monitors and collects results from child AI agent sessions with the agent-deck terminal session manager. This skill drives agent-deck, a terminal session manager for AI agents, so a parent Claude session can launch child sessions, watch them and collect what they produce. Commands cover creating a session in a working directory, starting, stopping and restarting it, showing status for all sessions or details (also as JSON) for one, and printing a session's output on request.
When should I use Agent Deck Sessions?
Agent Deck Sessions fits situations like: starting a sub-agent in its own session with a prompt; checking the status of running agent sessions; fetching a session's output on request; attaching an MCP server to a session and restarting it.
How do I install Agent Deck Sessions in Claude Code?
Run `npx skills add artwist-polyakov/polyakov-claude-skills --skill agent-deck -a claude-code`. Or copy the skill folder (plugins/agent-deck/skills/agent-deck in artwist-polyakov/polyakov-claude-skills) into .claude/skills/agent-deck in your project. Claude Code loads it when a task matches its description.
How do I install Agent Deck Sessions in Codex?
Run `npx skills add artwist-polyakov/polyakov-claude-skills --skill agent-deck -a codex`. Or copy the skill folder (plugins/agent-deck/skills/agent-deck in artwist-polyakov/polyakov-claude-skills) into .agents/skills/agent-deck in your project. Codex loads it when a task matches its description.
Can I use Agent Deck Sessions in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add artwist-polyakov/polyakov-claude-skills --skill agent-deck -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/agent-deck, .gemini/skills/agent-deck, .github/skills/agent-deck and .opencode/skills/agent-deck in your project.
What does Agent Deck Sessions need to run?
Going by SKILL.md and its folder, Agent Deck Sessions needs a shell for the scripts in its folder. Our summary lists: The agent-deck CLI.
Does Agent Deck Sessions access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Agent Deck Sessions safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Agent Deck Sessions use?
Agent Deck Sessions is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Agent Deck Sessions use?
About 965 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.5k tokens, read only when the agent opens those files.
What are the alternatives to Agent Deck Sessions?
Skills that share tags, products or a category with Agent Deck Sessions: Puppetmaster Agent Orchestration (professorpalmer/Puppetmaster, 467 stars), Ruflo Multi-Agent Orchestration (ruvnet/ruflo, 74k stars), Run Wave (jpicklyk/task-orchestrator, 207 stars) and Sandboxed.sh Missions (Th0rgal/sandboxed.sh, 515 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Agent Deck Sessions?
artwist-polyakov (a GitHub user) maintains it in artwist-polyakov/polyakov-claude-skills, which has 206 GitHub stars. The repository holds 21 skills in this directory. The repository was last updated on September 23, 2026.
Source: artwist-polyakov/polyakov-claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.