Published: 2026-05-30

Claude Code Dynamic Workflows: Skills vs Sub-Agents vs Agent Teams Explained

Chapters / key moments (click to jump — plays here on the page)

Nate Herk demystifies Claude Code's new dynamic workflows feature from Opus 4.8, drawing clear lines between skills, sub-agents, agent teams, and workflows. A single workflow run analyzing 41 skills consumed 5 million input tokens and burned through half his $200/month plan — these are powerful tools, but they demand respect for cost.

Source video

"Claude Code Dynamic Workflows Clearly Explained" by Nate Herk — Watch on YouTube →

Key Takeaways

  • Workflows generate a JavaScript script that orchestrates hundreds of parallel sub-agents, each working a different piece and reporting results to one master session.
  • The agent hierarchy: Skills = reusable recipes; Sub-agents = parallel workers with isolated context; Agent teams = group chat with shared task lists; Workflows = dynamically scripted multi-agent orchestrators.
  • A single workflow analyzing 41 skills consumed 5 million input tokens — always acknowledge the cost prompt before kicking one off.
  • Workflows confirm with you before launching and save as reusable scripts so you can re-run the same orchestration later.
  • Best for heavy-lifting code tasks: codebase sweeps, security audits, large PR reviews. Overkill for typical daily knowledge-work or skill automation.

The Four-Tier Agent Hierarchy

Nate lays out a clear "ladder" for choosing the right Claude Code feature. At the base is your main session — you prompt and Claude reasons, fetches, or calls APIs. One step up, Skills are reusable saved processes: you define them once and invoke them repeatedly, either manually or through automation. Sub-agents run parallel to the main session and handle isolated tasks, but they don't share context with each other — only with the main session that spawned them. Agent Teams add inter-agent communication: a small crew shares a context and can debate and delegate tasks, useful for war-room scenarios. Workflows sit at the top: Claude writes a JavaScript file that scripts the entire orchestration, spinning up potentially hundreds of sub-agents to work in parallel before synthesizing results.

The tradeoff is straightforward — more power and functionality equals more risk and cost. Nate emphasizes that not every feature is for everyone: for automation and knowledge work (versus heavy software engineering), he personally doesn't expect to reach for workflows often.

When Workflows Make Sense

The clearest use case is large-scale parallel processing: analyzing a whole codebase, auditing every API endpoint, or porting code across many files simultaneously. When the task would require too many sequential steps to fit in a single context window and can be cleanly partitioned into independent units, workflows shine. For anything smaller — summarizing a document, writing a skill, answering a question — stick with sub-agents or plain session prompts.

What you can actually set up from this

Extracted from the video's own transcript — the specifics the original summary left out.

Commands & Code Shown

/workflows

Purpose: Open the workflow progress view: watch, pause, resume or save running and finished workflows.

When to use: While a workflow runs, to check agents, models, tokens and tools per agent.

/deep-research <question>

Purpose: Bundled workflow: fans out web searches, cross-checks sources, votes on each claim and returns a cited report.

When to use: Research questions where you want claims cross-checked rather than one agent's summary.

/effort ultracode

Purpose: Make Claude plan a workflow for every substantive task in the session (session-only).

When to use: Only for sessions of large, parallelisable jobs — it is the most expensive setting.

Reproducible steps

  1. Pick the right rung of the ladder

    Quick thing: just ask. Repeated thing: a skill. Messy side task: a subagent. A crew that must talk to each other: an agent team. Keep going until a condition is true: /goal. A giant parallel job: a dynamic workflow.

  2. Ask for a workflow explicitly

    He found "set me up a dynamic workflow to do X" the reliable trigger. Claude asks permission before running and lets you view the generated JavaScript first.

  3. Save a workflow you will re-run

    In /workflows select the run and press s. The save dialog toggles between .claude/workflows/ (project, shared with the repo) and ~/.claude/workflows/ (personal). He had to ask for the project location explicitly.

  4. Bound the job before you start it

    Name the deliverable and the scope, and ask for worker agents on Haiku. His skills audit ran 41 Haiku scorers feeding one Opus synthesis agent.

Gotchas

  • Cost is real: one broad workflow (crawl the whole desktop) used about half of his $200/month plan in ~30 minutes. Most tokens were input, so it was cheaper than it looked, but still large.
  • Limits per the Claude Code docs: up to 16 concurrent agents by default (CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS raises it, 1–256, v2.1.269+) and 1,000 agents total per run.
  • Workflow agents do not talk to each other — they report back and are merged. If agents need to debate or share a task list, that is an agent team, not a workflow.
  • Typing the word "workflow" highlights it in the prompt but does not always mean a workflow will run.

Weekly Digest — In Your Inbox

Get the week's top AI agent news, updates, and guides — every Friday.