agent-designer

Design multi-agent swarm orchestration with defined roles and state machines.

Updated Mar 5, 2026
One-click install
npx skills add https://github.com/ShubhamManachekar/GeoSupply --skill agent-designer-shubhammanachekar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-designer
Source: https://github.com/ShubhamManachekar/GeoSupply/tree/main/.agent/skills/agent-designer
Command: npx skills add https://github.com/ShubhamManachekar/GeoSupply --skill agent-designer-shubhammanachekar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a blueprint for designing scalable, secure multi-agent systems, including layer definitions, role archetypes, and orchestration patterns for GeoSupply's 7-layer swarm.

Core Features & Use Cases

  • Agent Archetypes: Coordinator, Specialist, Monitor, and Audit agents with defined responsibilities and interaction patterns.
  • State Machine Design: Enforced valid transitions and testable transition rules to ensure robust lifecycle management.
  • Communication & Orchestration: Top-down task dispatch, event-driven updates, and MoE-based routing for expert selection.
  • Failure Handling & Observability: Circuit breakers, error handling, traceable messages, and safety checks.
  • New Agent Checklist & Discovery: Standardized onboarding and dynamic discovery via subclass enumeration.

Quick Start

Create a new agent by inheriting BaseAgent, implement execute with known actions, define _VALID_TRANSITIONS, and wire up setup and teardown.

Frequently Asked Questions about agent-designer

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

FAQPage Schema
How do I design a multi-agent system with deterministic routing across multiple layers?

Designing a multi-agent system with deterministic routing requires defining agent archetypes, strict state machine transitions, and top-down task dispatch. This blueprint provides Coordinator, Specialist, Monitor, and Audit agents for managing dozens of agents across layers 0 through 7.

What is MoE gating in multi-agent orchestration and when do I need it?

MoE gating in multi-agent orchestration is a routing mechanism for expert selection within a swarm. You need it when complex workflows require fault-tolerant coordination and dynamic routing to specialized agents, ensuring safe and observable interactions via a centralized EventBus.

How to implement fault-tolerant coordination for a large-scale agent swarm?

Implement fault-tolerant coordination for an agent swarm by applying circuit breakers, error handling, and traceable messages. Define valid state transitions and use a centralized EventBus to ensure safe, observable interactions and robust lifecycle management across all agent layers.

Can I use state machine design to enforce valid transitions for agent lifecycle management?

Yes, state machine design enforces valid transitions and testable transition rules for agent lifecycle management. By defining _VALID_TRANSITIONS and implementing execute with known actions, you ensure robust, structured behavior for Coordinator, Specialist, Monitor, and Audit agents.

What's the best way to handle agent discovery and onboarding in a layered architecture?

Handle agent discovery and onboarding in a layered architecture by using a standardized new agent checklist and dynamic discovery via subclass enumeration. Inherit BaseAgent, implement setup and teardown, and wire up known actions to integrate new agents into the swarm.

Why does my multi-agent orchestration fail without strict transition graphs?

Multi-agent orchestration fails without strict transition graphs because agents enter invalid states, breaking deterministic routing and top-down task dispatch. Enforcing valid state transitions and testable rules prevents these faults and ensures robust coordination across the swarm's 7 layers.