subagents-orchestration-guide SKILL.md skillA

subagents-orchestration-guide from shinpr/codex-workflows is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add shinpr/codex-workflows/subagents-orchestration-guide@git:20261103.5840a80

Pins git:20261103.5840a80 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
shinpr/codex-workflows
Path
.agents/skills/subagents-orchestration-guide/SKILL.md
Versions recorded
16
Latest version
git:20261103.5840a80, committed Nov 3, 2026
First version recorded
Sep 8, 2026
Size
34,424 bytes
Repository stars
39
License
MIT

Coordinates custom specialists through workflow phases, artifact handoffs, approval gates, and autonomous implementation. Use when executing a workflow recipe or routing its next specialist.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Subagents Orchestration Guide

Load `subagent-delegation` for assignment, waiting, and intervention rules. This guide owns workflow-specific coordination.

**Invocation rule**: Start each named agent with `spawn_agent` and `fork_turns="none"`. When invoking the same named agent again within this flow, use `followup_task` on its existing instance with the inputs specified for the current invocation.

## Role: The Orchestrator

The orchestrator owns workflow state and directly performs lightweight coordination: locating artifacts, reading status fields, resolving paths, applying explicit user answers, updating execution plans and continuation records, running deterministic repository checks, and filling specialist input contracts from their sources. Invoke a specialized subagent when a recipe names that role or the work requires its domain judgment or implementation authority.

### Purpose and Decision Authority
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add shinpr/codex-workflows/subagents-orchestration-guide@sha256:5c2738f81721889f

The line at the top of this page pins the label git:20261103.5840a80, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_pchsbyd5hb6hnqiz.svg)](https://markdownregistry.com/a/art_pchsbyd5hb6hnqiz)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 16 versions of this file, between Sep 8, 2026 and Nov 3, 2026, about one every 4 days.

versioncommittedcommitsizeaudit
git:20261103.5840a80 latest2026-11-03 5840a80 34,424 BA view · diff
git:20261102.2a1d2f62026-11-02 2a1d2f6 34,204 BA view · diff
git:20261102.ce009f82026-11-02 ce009f8 34,268 BA view · diff
git:20261029.c5886172026-10-29 c588617 32,951 BA view · diff
git:20261022.e38db2d2026-10-22 e38db2d 32,984 BA view · diff
git:20261002.67d25442026-10-02 67d2544 32,776 BA view · diff
git:20261001.eefec1e2026-10-01 eefec1e 32,663 BA view · diff
git:20260917.67474b72026-09-17 67474b7 32,388 BA view · diff
git:20260916.ad307bb2026-09-16 ad307bb 30,869 BA view · diff
git:20260915.0c8f5172026-09-15 0c8f517 30,668 BA view · diff
git:20260915.3b2dc522026-09-15 3b2dc52 30,451 BA view · diff
git:20260912.46c19412026-09-12 46c1941 28,537 BA view · diff
git:20260909.df0b42a2026-09-09 df0b42a 28,610 BA view · diff
git:20260909.14556d72026-09-09 14556d7 28,998 BA view · diff
git:20260909.a37998e2026-09-09 a37998e 28,711 BA view · diff
git:20260908.861012c2026-09-08 861012c 27,570 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (34424 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

shinpr/codex-workflows · 39 stars · license MIT · pushed 2026-11-03 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_pchsbyd5hb6hnqiz
GET https://markdownregistry.com/api/v1/resolve?ref=shinpr/codex-workflows/subagents-orchestration-guide
GET https://markdownregistry.com/api/v1/blob/5c2738f81721889f69e9d61e9c854bd03cf18b4a89b52297da7f66fda7a38656

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from shinpr/codex-workflows

ai-development-guide SKILL.md skill
shinpr/codex-workflows · .agents/skills/ai-development-guide/SKILL.md · Root-cause discipline, proportionate impact analysis, and implementation completeness assurance. Use when fixing bugs…
git:20261102.2a1d2f6 · audit A · 39 stars
coding-rules SKILL.md skill
shinpr/codex-workflows · .agents/skills/coding-rules/SKILL.md · Repository-aware implementation rules for minimal design surface, contract safety, representative patterns, and…
git:20260922.5475540 · audit A · 39 stars
documentation-criteria SKILL.md skill
shinpr/codex-workflows · .agents/skills/documentation-criteria/SKILL.md · Determines which PRD, ADR, UI Spec, Design Doc, and Work Plan a change requires and where each document lives. Use when…
git:20261102.2a1d2f6 · audit A · 39 stars
external-resource-context SKILL.md skill
shinpr/codex-workflows · .agents/skills/external-resource-context/SKILL.md · Resolves and records one external evidence source required by a current design or verification decision. Use when…
git:20260915.0c8f517 · audit A · 39 stars
implementation-approach SKILL.md skill
shinpr/codex-workflows · .agents/skills/implementation-approach/SKILL.md · Selects the smallest sufficient implementation strategy and verification boundary from current requirements and…
git:20261102.2a1d2f6 · audit A · 39 stars
integration-e2e-testing SKILL.md skill
shinpr/codex-workflows · .agents/skills/integration-e2e-testing/SKILL.md · Selects and specifies the integration/E2E tests that own accepted behavior at the boundary where it is observable.
git:20261102.2a1d2f6 · audit A · 39 stars
llm-friendly-context SKILL.md skill
shinpr/codex-workflows · .agents/skills/llm-friendly-context/SKILL.md · Clarifies inputs, outputs, success criteria, decisions, and unresolved conditions so downstream agents can execute…
git:20261022.e38db2d · audit A · 39 stars
recipe-add-integration-tests SKILL.md skill
shinpr/codex-workflows · .agents/skills/recipe-add-integration-tests/SKILL.md · Add integration/E2E tests to existing codebase using Design Docs.
git:20261023.aaf52b6 · audit A · 39 stars
recipe-build SKILL.md skill
shinpr/codex-workflows · .agents/skills/recipe-build/SKILL.md · Execute an approved backend Work Plan autonomously through task execution, quality fixes, commits, and final…
git:20261023.aaf52b6 · audit A · 39 stars
recipe-design SKILL.md skill
shinpr/codex-workflows · .agents/skills/recipe-design/SKILL.md · Execute from codebase-scoped analysis to design document creation.
git:20261102.2a1d2f6 · audit A · 39 stars
recipe-diagnose SKILL.md skill
shinpr/codex-workflows · .agents/skills/recipe-diagnose/SKILL.md · Investigate problem, verify findings, and derive solutions through structured diagnosis.
git:20261023.aaf52b6 · audit A · 39 stars
recipe-front-adjust SKILL.md skill
shinpr/codex-workflows · .agents/skills/recipe-front-adjust/SKILL.md · Adjust an implemented UI with focused evidence, verification, and quality checks.
git:20261023.aaf52b6 · audit A · 39 stars

Every file in shinpr/codex-workflows

Other files named subagents-orchestration-guide

subagents-orchestration-guide SKILL.md skill
shinpr/claude-code-workflows · dev-workflows/skills/subagents-orchestration-guide/SKILL.md · Guides subagent coordination through implementation workflows. Use when orchestrating multiple agents, managing…
git:20261106.93b67d5 · audit A · 712 stars
subagents-orchestration-guide SKILL.md skill
shinpr/claude-code-workflows · skills/subagents-orchestration-guide/SKILL.md · Guides subagent coordination through implementation workflows. Use when orchestrating multiple agents, managing…
git:20261029.29a1f7c · audit A · 712 stars
subagents-orchestration-guide SKILL.md skill
shinpr/claude-code-workflows · dev-workflows-fullstack/skills/subagents-orchestration-guide/SKILL.md · Guides subagent coordination through implementation workflows. Use when orchestrating multiple agents, managing…
git:20261029.29a1f7c · audit A · 712 stars
subagents-orchestration-guide SKILL.md skill
shinpr/claude-code-workflows · dev-workflows-frontend/skills/subagents-orchestration-guide/SKILL.md · Guides subagent coordination through implementation workflows. Use when orchestrating multiple agents, managing…
git:20261029.29a1f7c · audit A · 712 stars
subagents-orchestration-guide SKILL.md skill
shinpr/ai-coding-project-boilerplate · .claude/skills-zh-CN/subagents-orchestration-guide/SKILL.md · 通过基于规模的规划、审批、实现、验证和上报流程协调子智能体。用于将工作路由给子智能体、执行已批准的工作计划,或恢复自主执行时使用。
git:20261108.849ffac · audit A · 236 stars
subagents-orchestration-guide SKILL.md skill
shinpr/ai-coding-project-boilerplate · .claude/skills-en/subagents-orchestration-guide/SKILL.md · Coordinates subagents through scale-based planning, approval, implementation, verification, and escalation flows. Use…
git:20261108.8996d06 · audit A · 236 stars
subagents-orchestration-guide SKILL.md skill
shinpr/ai-coding-project-boilerplate · .claude/skills-ja/subagents-orchestration-guide/SKILL.md · 規模に応じた計画、承認、実装、検証、エスカレーションのフローでサブエージェントを調整。サブエージェントへの作業振り分け、承認済み作業計画の実行、自律実行の再開時に使用。
git:20261108.849ffac · audit A · 236 stars

Browse by kind, by grade A, or by owner.