К основному содержанию
скилл CX Codex

marshal — скилл для Claude Code: автоматизированная цепочка действий

Скилл marshal для Claude Code разбирает задачу, собирает контекст из кода и памяти и связывает скиллы в цепочку. Работает за одну сессию и спрашивает, только если не может продолжить.

MIT ★ 937 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add SethGammon/Citadel
/plugin install citadel@citadel-local
Открыть на GitHub

Что делает marshal

Marshal разбирает задачу на структурированные шаги: понял → спланировал → выполнил → доложил. Сначала читает архитектурные документы проекта (AGENTS.md, CLAUDE.md), определяет, какие файлы трогать и в каком режиме работать. Потом вызывает нужные скиллы в последовательности, собирает контекст параллельно, проверяет каждый результат.

Два основных режима: /marshal [направление] — полный цикл от анализа к отчёту; /marshal assess [область] — только исследование без правок. Таймауты на подагентов встроены (10 минут для скиллов, 15 для исследований), чтобы не зависнуть. Если направление размыто, спросит один уточняющий вопрос, но не будет просить описать каждый шаг.

Git-история, паттерны в коде, документация — всё собирает автоматически. Если что-то упирается, один раз переходит на альтернативный подход. На выходе структурированный отчёт с ссылками на строки кода и блок HANDOFF с тем, что изменилось и как откатить.

Какие задачи решает

  • разобраться в многошаговой задаче без перепроверки каждого шага
  • собрать контекст из документации и памяти перед действием
  • автоматически выбрать, какой скилл вызвать на каком этапе
  • получить структурированный отчёт о том, что сделано и почему
  • откатить изменения, если они пошли не туда

Примеры запросов агенту

  • Оркестрируй проверку безопасности: почитай логи, найди аномалии, дай рекомендации
  • Улучши код в директории src/auth — проанализируй текущее, найди баги, чини
  • Исследуй архитектуру и предложи, как рефакторить модули в backend

Как установить marshal

1Через маркетплейс плагинов

/plugin marketplace add SethGammon/Citadel
/plugin install citadel@citadel-local

Команда ставит плагин citadel целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add SethGammon/Citadel --skill marshal -a claude-code

3Вручную: положить файлы

~/.claude/skills/marshal/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/marshal/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о marshal

Как установить marshal в Claude Code?

Выполни /plugin marketplace add SethGammon/Citadel, затем /plugin install citadel@citadel-local и npx skills add SethGammon/Citadel --skill marshal -a claude-code. Скилл загрузится в ~/.claude/skills/marshal/SKILL.md.

Что делает marshal?

Берёт описание задачи (чёткое или размытое) и самостоятельно цепляет скиллы, собирает контекст из проекта, выполняет действия и докладывает результат с ссылками на код. Не спрашивает без надобности.

Когда marshal подойдёт, а когда нет?

Подойдёт для многошаговых работ, которые можно закончить в одну сессию: аудит, фикс с расследованием, улучшение куска кода. Не подойдёт для задач, растянутых на несколько сессий (нужен /archon) или распараллеливаемых на 3+ потока (нужен /fleet).

Исходный текст

SKILL.md · MIT
---
name: marshal
license: MIT
description: >-
  Meta-orchestrator that takes any direction — broad, specific, or vague — and
  autonomously chains skills and context into actionable work. Gathers context
  from codebase, docs, and memory. Only asks the user when it genuinely cannot
  proceed. Single-session orchestrator.
user-invocable: true
auto-trigger: false
trigger_keywords:
  - orchestrate
  - chain skills
  - multi-step
last-updated: 2026-03-20
---

# /marshal — Session Commander

## Orientation

Use Marshal when the task is:
- Multi-step but bounded (completable in one session)
- Needs investigation before action
- Spans multiple skills but doesn't need campaign persistence
- Too complex for a single skill but doesn't need Archon/Fleet

**Don't use when:** the task spans multiple sessions (use /archon); work decomposes into 3+ parallel streams (use /fleet); you only need research with no action (use /research).
- Parallel execution (use Fleet)

## Commands

| Command | Behavior |
|---|---|
| `/marshal [direction]` | Full loop: understand → plan → execute → report |
| `/marshal assess [area]` | Read-only: understand the area, produce findings, don't fix |

## Protocol

### Phase 1: UNDERSTAND

Parse the user's direction into structured intent:

1. Read AGENTS.md, then CLAUDE.md if present, to understand the project's architecture and conventions
2. Identify: scope (which files/directories), perspective (user, developer, admin),
   mode (audit, fix, build, improve, map), depth (surface scan vs deep investigation)
3. If the direction is ambiguous, make a reasonable interpretation and state it.
   Do NOT ask clarifying questions unless genuinely stuck.

### Phase 2: PLAN CHAIN

Map the intent to a sequence of actions:

| Direction Pattern | Chain |
|---|---|
| "audit [area]" | explore → analyze → report findings |
| "fix [thing]" | investigate root cause → fix → verify → report |
| "map [area]" | read files in parallel → synthesize → produce analysis |
| "improve [area]" | audit current state → identify gaps → implement → verify |
| "what should [X] be" | research → analyze options → recommend with reasoning |
| "research [topic]" | search codebase + web → synthesize → report |

Announce the chain before executing: "I'll [step 1], then [step 2], then [step 3]."

### Phase 3: EXECUTE

For each step in the chain:

1. Load the relevant skill if one exists (e.g., `/review` for audit steps)
2. Gather context: read relevant files, check git history, search for patterns
3. Perform the action
4. Check the result against the plan — did it produce what was expected?
5. If a step fails, try one alternative approach before escalating

### Phase 4: REPORT

Produce a structured report:

```
=== Marshal Report ===

Direction: {original direction}
Scope: {what was examined}

Findings:
- {finding 1 with file:line reference}
- {finding 2}

Actions Taken:
- {what was changed, if anything}

Recommendations:
- {next steps if applicable}
```

### Phase 5: LEARN

If the investigation revealed reusable patterns or pitfalls:
- Note them in the report
- Suggest creating a skill if a pattern will recur: "This pattern would
  make a good skill. Run `/create-skill` to capture it."

## Agent Timeouts

When Marshal spawns sub-agents (e.g., for parallel investigation or delegated
skill execution), it must enforce execution time limits. Sub-agents can hang
indefinitely on tool calls — the circuit breaker catches failures, not hangs.

### Default Timeouts

| Agent Type | Default Timeout |
|---|---|
| Skill-level agents | 10 minutes |
| Research agents | 15 minutes |

Timeouts are configurable in `harness.json` under `agentTimeouts` (same config
Fleet uses). If an agent exceeds its timeout:

1. Log the timeout in telemetry
2. Check for partial output — extract usable findings if any
3. Try one alternative approach (simpler prompt, reduced scope)
4. If retry also times out, skip and note the gap in the report

Never wait indefinitely. A timed-out agent's scope becomes a "gap" in the
Marshal Report's Findings section.

## Fringe Cases

- **Direction is vague** (e.g., "do the thing", "fix it", "make it better"): Ask one clarifying question before proceeding. Do not attempt to guess scope on truly ambiguous input — one focused question is cheaper than executing the wrong plan.
- **A sub-task fails on first attempt**: Retry once with a different approach (narrower scope, different tool, simpler method). If the second attempt also fails, record the blocker in the report and move on.
- **No relevant files found for the stated scope**: Report the empty result honestly. Do not fabricate findings. Suggest the user verify the scope or file paths.
- **CLAUDE.md missing**: Proceed without it. Note the absence in the report so the user knows project conventions weren't applied.
- **Typecheck not configured**: Skip the verification step and note it as "unverified" in the report rather than blocking completion.

## Quality Gates

- Every finding must cite a specific file and line number
- Every action must be verified (typecheck passes, tests pass)
- If a fix was applied, confirm the original issue is resolved
- The report must be concise — no filler, no repetition
- If you're stuck on a step for more than 3 attempts, skip it and report the blocker

## Exit Protocol

1. Output the Marshal Report (format above)
2. If work items were discovered but not addressed, suggest creating intake items
3. Output a HANDOFF block summarizing what was done

```
---HANDOFF---
- What: {behavior changed or goal achieved — not the file name, the outcome}
- Decisions: {key tradeoffs made — include the alternative that was rejected}
- Unresolved: {what is still open or blocked — actionable next step}
- Reversibility: {green | amber | red} — {how to undo}
---
```

© SethGammon · MIT · SethGammon/Citadel

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
context-builder glebis Скилл context-builder для Claude Code, Codex, Cursor и других платформ, который генерирует интерактивные промпты для сбора контекста у клиентов консалтинговых проектов по AI-трансформации. CX Codex +1 226установок deep-agents-core langchain-ai Скилл deep-agents-core для создания многошаговых агентов с задачами, контекстом и делегированием. Встроенная система управления файлами, хранение данных между сеансами и субагенты — всё настраивается, не кодится. CX Codex +1 16 900установок investigate cyrusagents Скилл investigate ищет файлы и функции в репозитории, собирает контекст и готовит ответ в формате Markdown для Linear. Пригодится при разборе задач и багов. CX Codex +1 908установок planning-with-files OthmanAdi Скилл planning-with-files для Claude Code и Codex, который сохраняет план, находки и журнал сессии в файлы на диске. При следующем запуске агент читает task_plan.md, findings.md и progress.md и продолжает с того места, где остановился. CX Codex +1 ★ 28 179звёзд репо qoder-delegate amElnagdy Скилл qoder-delegate для Claude Code отправляет задачу имплементации в Qoder CLI фоновым процессом, оставляя оркестратор рецензентом. Агент передаёт бриф и получает diff для проверки и коммита. CX Codex +1 3 600установок gsd-plan-review-convergence open-gsd Скилл gsd-plan-review-convergence для Claude Code и Codex запускает цикл ревью и доработки плана разработки с участием нескольких внешних ИИ-агентов. CX Codex +1 581установок

Из того же набора55

Весь набор →
systematic-debugging Скилл systematic-debugging ограничивает хаотичные правки: заставляет модель сначала воспроизвести баг, проверить гипотезы без изменения кода и остановиться после двух неудачных правок. CX Codex +1 ★ 937звёзд репо decision-map Скилл decision-map превращает расплывчатую идею в карту вопросов, которую можно продолжать между сессиями. Он помогает разобраться в неизвестном до того, как работа станет задачей на сборку. CX Codex +1 ★ 937звёзд репо archon Субагент archon, который ведёт большую задачу по фазам: разбивает направление на шаги, передаёт их другим агентам и хранит состояние кампании между запусками. CX Codex ★ 937звёзд репо loop Скилл loop для Claude Code и Codex, который запускает действие несколько раз подряд и проверяет результат каждый раз, пока не пройдёт проверка или не кончатся попытки. CX Codex +1 ★ 937звёзд репо test-gen Скилл test-gen генерирует и прогоняет тесты под существующий фреймворк проекта с проверкой типичных сценариев, краевых случаев и ошибок. CX Codex +1 ★ 937звёзд репо design Скилл design собирает дизайн-манифест из стилей проекта или ответов на вопросы. Хук после правок отмечает отклонения в CSS и компонентах. CX Codex +1 ★ 937звёзд репо live-preview Скилл live-preview делает скриншоты компонентов в процессе сборки, а не по готовности. Ловит регрессии вёрстки и невидимые блоки до того, как они уйдут дальше. CX Codex +1 ★ 937звёзд репо architect Скилл architect превращает PRD или описание задачи в архитектурный план с деревом файлов, моделью данных и фазами сборки. CX Codex +1 ★ 937звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой