# Agent Child Runner

> Internal resident worker for delegated child Agent runs.

- Skill: `erixwong/agent-child-runner` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add erixwong/agent-child-runner`
- Raw SKILL.md: https://api.skillmd.com/api/skills/erixwong/agent-child-runner/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: erixwong (https://skillmd.com/u/erixwong)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/erixwong/agent-child-runner

---


# Agent Child Runner

Internal resident worker for asynchronous child Agent execution.

This skill is not intended to be exposed directly to the LLM. Root Agent control
tools call it through `ResidentSkillManager.invokeByName()` using the
`agent-child-runner` / `invoke` entrypoint.

## Protocol

Input is a JSON object with an `action` field:

- `start`: accepts an accepted delegation envelope and returns a child run handle immediately.
- `status`: returns the current child run status.
- `result`: returns completed result and buffered events.
- `events`: returns buffered child run events.
- `cancel`: requests cancellation.

The worker owns run state. Actual child Agent execution is delegated back to the
main service through `/internal/agent/child-run/execute`, preserving the main
process AgentLoop, ToolManager, and database service boundaries.