Skip to content
Get packs

agent-squad Python assistant guide

Build Python apps with the agent-squad multi-agent orchestration package

Source Download skill
Repository
2FastLabs/agent-squad
Stars
7,795
Licence
Apache-2.0
Files
15 files

What it does

This skill gives an AI coding agent a map of the agent-squad Python framework, which lets a program route user messages to several specialist AI agents. Once installed, the agent knows which agent type to pick (single assistant, multi-agent router, grounded answers, pipelines, supervisor teams, or external tool servers), which optional install extras to add, and common pitfalls such as always awaiting route_request and branching on response.streaming. It tells the agent to read exact signatures from the framework source rather than relying on the guide alone.

Great for

  • Python developers building a chatbot or assistant that hands requests to different specialist agents
  • Teams using AWS Bedrock, Anthropic, or OpenAI models who want a ready-made orchestration layer
  • Developers adding MCP tool servers to an agent application

Skip it if

  • Non-programmers who only want a chat assistant; this skill helps write Python code, not answer questions directly
  • Projects that do not use the agent-squad package, since the guide is specific to it and may mislead on other frameworks

Try asking

  • “Help me set up an AgentSquad orchestrator with a Bedrock classifier and two specialist agents”
  • “Add streaming responses to my existing route_request call in this Python app”
  • “Which agent type should I use for a pricing bot that must not invent numbers?”
  • “Wire an MCP tool server into my agent-squad project”
Step-by-step guide: how to use agent-squad Python assistant guideInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 15 original files, the Apache-2.0 licence and an attribution note.

    python.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip python.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip python.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Ask the agent to check exact signatures in the installed source, since the guide itself says it is not an API reference
  • Install only the extras you need so optional SDKs are not pulled in unnecessarily
  • Keep API keys in environment variables or a secrets manager, not in code the agent writes

What's inside

  • CONTRIBUTING.md
  • pyproject.toml
  • README.md
  • ruff.toml
  • setup.py
  • SKILL.md
  • src/agent_squad/__init__.py
  • src/agent_squad/agent_overlap_analyzer.py
  • src/agent_squad/agents/__init__.py
  • src/agent_squad/agents/agent.py
  • src/agent_squad/agents/amazon_bedrock_agent.py
  • src/agent_squad/agents/anthropic_agent.py
  • src/agent_squad/agents/bedrock_flows_agent.py
  • src/agent_squad/agents/bedrock_inline_agent.py
  • src/agent_squad/agents/bedrock_llm_agent.py

Redistributed unmodified from 2FastLabs/agent-squad under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.