Agent Tooling and Orchestration

Design agent capabilities as contracts with measurable behavior. Prefer the smallest capability surface that reliably changes outcomes.

Classify the task

• Creating or revising a reusable skill: skill-lifecycle.md.
• Designing tools, resources, prompts, or an MCP-style server: tool-interface-design.md.
• Splitting work among multiple agents: orchestration.md.
• Finding, evaluating, or installing an existing capability: capability-discovery.md;
• Designing observations, runtime context, or persistent-agent operations: runtime-and-context.md.

Do not turn one-off domain instructions into a reusable skill unless repetition, error cost, or specialized resources justify it.

Define the contract

Before building, state: