Contribute Your Agent

Share your AI agents with the community. Follow these simple steps to contribute your agent to the ADK Agent Directory.

1

Fork the Repository

Fork the ADK Agent Directory repository on GitHub to create your own copy.

2

Create Your Agent

Develop your agent following the ADK structure and best practices.

3

Add Metadata

Create a metadata.json file with agent information, use cases, and sample prompts.

4

Submit Pull Request

Submit a pull request with your agent for review and inclusion.

Metadata Template

Create a metadata.json file in your agent directory with the following structure:

{
  "name": "your_agent_name",
  "displayName": "Your Agent Display Name",
  "description": "A brief description of what your agent does",
  "tools": [
    "tool1",
    "tool2"
  ],
  "tags": [
    "tag1",
    "tag2"
  ],
  "useCases": [
    "Use case 1",
    "Use case 2"
  ],
  "samplePrompts": [
    "Example prompt 1",
    "Example prompt 2"
  ],
  "author": "Your Name",
  "githubUrl": "https://github.com/yourusername/your-repo",
  "documentation": "https://your-docs-url.com",
  "version": "1.0.0"
}

Guidelines

Agent Quality

Ensure your agent is well-tested, documented, and follows ADK best practices.

Complete Metadata

Provide accurate descriptions, use cases, tags, and sample prompts to help users discover your agent.

Documentation

Include a README.md file explaining how to use your agent, setup instructions, and any dependencies.

Code Quality

Follow Python best practices, include type hints, and ensure your code is maintainable.