run-agent

Assemble a Context Envelope and spawn a Task tool subagent to execute tasks.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/ste-bah/archon --skill run-agent-ste-bah
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: run-agent
Source: https://github.com/ste-bah/archon/tree/main/.claude/agents/.claude/skills/run-agent
Command: npx skills add https://github.com/ste-bah/archon --skill run-agent-ste-bah

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines the process of launching and coordinating custom agents by automatically assembling the necessary context and delegating task execution to a dedicated subagent.

Core Features & Use Cases

  • Context envelope orchestration: Aggregates agent definitions, memory (MemoryGraph), and LEANN results to form a complete execution context.
  • Agent validation & execution: Validates the target agent exists and has a valid agent.md, then spawns a subagent to run the specified task.
  • Memory and behavior integration: Injects memory-driven behavioral rules and optional code search context into the task prompt; supports tracing and auditing for later analysis.

Quick Start

Provide an agent name and a task description to run, e.g., /run-agent sec-filing-analyzer 'Analyze the latest 10-K filing for insights'.

Frequently Asked Questions about run-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I launch a custom agent to execute a specific task on demand?

To launch a custom agent, provide an agent name and a task description to automatically assemble a context envelope and spawn a subagent for execution. The tool validates the target agent exists and has a valid agent.md before running.

How does context envelope orchestration work for subagent execution?

Context envelope orchestration aggregates agent definitions, memory from MemoryGraph, and LEANN results to form a complete execution context. It injects memory-driven behavioral rules and optional code search context into the task prompt before spawning the subagent.

What inputs are required to run a subagent task?

Running a subagent task requires the agent_name and task arguments, with optional model overrides. The system validates these inputs, ensures the target agent exists, and handles errors before execution.

Can I override the model when spawning a subagent?

Yes, you can provide optional model overrides when launching a subagent task. The system accepts these overrides alongside the required agent_name and task arguments to configure the execution.

What sections are included in the structured prompt sent to the subagent?

The structured prompt includes ROLE, DOMAIN CONTEXT, TOOL INSTRUCTIONS, BEHAVIORAL RULES, MEMORY CONTEXT, and YOUR TASK sections. These sections are assembled from the agent definitions and memory context.

Does the agent execution tool support tracing and auditing?

Yes, the tool manages tracing and memory insertion throughout the run for later analysis. This ensures subagent execution is auditable and memory context is preserved after the task completes.