a2a-agent

Build, test, and deploy A2A agents with a2a-sdk and FastAPI.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/pjordan/claude-toolkit --skill a2a-agent
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: a2a-agent
Source: https://github.com/pjordan/claude-toolkit/tree/main/skills/examples/a2a-agent
Command: npx skills add https://github.com/pjordan/claude-toolkit --skill a2a-agent

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

The a2a-agent skill provides a complete workflow to build, test, and deploy production-ready A2A agents using a2a-sdk and FastAPI.

Core Features & Use Cases

  • Scaffolding: generate new agents from basic or advanced templates.
  • Handler patterns: define request/response models and streaming handlers.
  • Deployment & testing: Docker-based deployment, health checks, and automated tests.

Quick Start

Install and run the scaffolding script: python scripts/create_agent.py <agent-name> --type basic|advanced --path <output-path>. Then navigate to the generated directory, install dependencies, and run the agent with the provided startup command.

Frequently Asked Questions about a2a-agent

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

FAQPage Schema
How do I build and deploy production-ready A2A agents using FastAPI?

You build and deploy production-ready A2A agents by using scaffolding scripts to generate FastAPI project structures from basic or advanced templates, then running the provided Docker assets and startup commands to serve the agent.

How do I scaffold a new agent-to-agent project from a template?

To scaffold an agent-to-agent project, run the Python scaffolding script with your desired agent name, specify the template type as basic or advanced, and define the output path to generate the complete project directory.

Does this workflow support streaming handlers and automated testing?

Yes, the workflow supports defining request/response models and streaming handlers, and includes automated tests alongside Docker-based deployment and health checks to validate agent behavior.

What is the best way to containerize an A2A agent for production?

The best way to containerize an A2A agent is using the provided Docker deployment assets included in the scaffolding output, which configure the FastAPI environment and health checks for production readiness.

Do I need prior FastAPI experience to use these A2A agent templates?

Familiarity with FastAPI environments is beneficial since the templates generate FastAPI applications, but the scaffolding script handles project structure setup and provides startup commands to run the agent immediately.

When should I choose the advanced template over the basic template for my agent?

Choose the advanced template when your domain-specific agent requires complex handler patterns, and use the basic template for simpler request/response models, with both supporting Docker deployment and testing.