sub-agents

PassAudited by ClawScan on May 10, 2026.

Overview

This instruction-only skill is coherent for sub-agent orchestration, but users should be mindful that spawned agents may run in parallel with broad inherited tool access and can receive files or attachments.

This skill appears benign and purpose-aligned, but it gives the agent a framework for delegating work to parallel sub-agents. Before using it, make sure delegated tasks are narrow, avoid passing secrets or unnecessary private files, require sandboxing for risky work, set timeouts for long tasks, and review any saved outputs when announcement suppression is used.

Findings (5)

Artifact-based informational review of SKILL.md, metadata, install specs, static scan signals, and capability signals. ClawScan does not execute the skill or run runtime probes.

What this means

A delegated sub-agent may be able to read, modify, or act through the same tools as the parent agent, depending on the task and runtime configuration.

Why it was flagged

The skill explicitly says child agents can use nearly all available tools and inherit sandbox behavior unless a stricter sandbox is required.

Skill content
Sub-agents get all tools EXCEPT session tools ... sandbox | inherit | require
Recommendation

Use precise task specs, set `sandbox: require` for risky work, configure least-privilege tool access where available, and avoid delegating broad or destructive tasks without review.

What this means

Files, attachments, or secrets included in a sub-agent task may be processed by another model/session and may also influence the final announcement.

Why it was flagged

The skill transfers task text, referenced files, and attachments to sub-agent sessions, which is expected for delegation but can expose sensitive information if over-shared.

Skill content
They only see: 1. The `task` string you provide 2. Whatever files you tell them to read ... 3. Inline `attachments` you pass at spawn time
Recommendation

Pass only the minimum necessary context, avoid including secrets or private files unless required, and specify exactly which paths and outputs the sub-agent may use.

What this means

A child agent may keep working while the parent continues, so mistakes or unnecessary work might happen in parallel if the task is poorly scoped.

Why it was flagged

Sub-agent sessions continue independently after being spawned and are retained by default until archival, though this behavior is disclosed and bounded by the documented session mechanism.

Skill content
Always non-blocking. Returns `{ status: "accepted", runId, childSessionKey }` immediately ... Auto-archive ... default: 60
Recommendation

Use `runTimeoutSeconds`, clear success criteria, and `cleanup: delete` when persistence is not needed; monitor child session results before relying on them.

What this means

Delegated work could run under a different configured agent identity with different permissions if allowed by the environment.

Why it was flagged

The skill documents the ability to spawn work under another agent identity, but also notes it is restricted by an allowlist.

Skill content
`agentId` ... Spawn under another agent (must be in allowlist)
Recommendation

Only use alternate `agentId` values intentionally, keep the allowlist narrow, and verify which agent identity will perform sensitive actions.

What this means

A sub-agent may complete without directly posting its result to the chat, so users may need to rely on the parent agent to summarize or surface the saved output.

Why it was flagged

The skill documents a mechanism to suppress sub-agent announcements for consolidation by the parent agent. This is disclosed, but it affects user-visible reporting.

Skill content
Your final reply after writing the file should be ONLY: ANNOUNCE_SKIP
Recommendation

Use announce suppression only when the parent agent will explicitly review and present the results; otherwise require a visible summary.