swarms/docs/swarms_platform/share_and_discover.md

# Swarms Marketplace Documentation

The Swarms Marketplace (`https://swarms.world`) is a vibrant community hub where developers, researchers, and agent enthusiasts share and discover cutting-edge agent tools, agents, and prompts. This collaborative platform empowers you to leverage the collective intelligence of the Swarms community while contributing your own innovations.

## What You Can Discover

### 🤖 Agents

Ready-to-use agent agents for specific tasks and industries:

- **Specialized Agents**: From healthcare diagnostics to financial analysis

- **Multi-Agent Systems**: Collaborative agent swarms for complex workflows

- **Industry Solutions**: Pre-built agents for healthcare, finance, education, and more

- **Custom Implementations**: Unique agent architectures and approaches


### 💡 Prompts

System prompts and instructions that define agent behavior:

- **Role-Specific Prompts**: Behavioral psychologist, documentation specialist, financial advisor

- **System Templates**: Production-grade prompts for various use cases

- **Collaborative Frameworks**: Multi-agent coordination prompts

- **Task-Specific Instructions**: Optimized prompts for specific workflows


### 🛠️ Tools

APIs, integrations, and utilities that extend agent capabilities:

- **API Integrations**: Connect to external services and data sources

- **Data Fetchers**: Tools for retrieving information from various platforms

- **Workflow Utilities**: Helper functions and automation tools

- **Communication Tools**: Integrations with messaging platforms and services


## Browsing and Discovery

### Category-Based Navigation

**Industry Categories:**

- **Healthcare**: Medical diagnosis, patient care, research tools

- **Education**: Learning assistants, curriculum development, assessment tools

- **Finance**: Trading bots, market analysis, financial planning

- **Research**: Academic paper fetchers, data analysis, literature review

- **Public Safety**: Risk assessment, emergency response, safety monitoring

- **Marketing**: Content creation, campagentgn optimization, audience analysis

- **Sales**: Lead generation, customer engagement, sales automation

- **Customer Support**: Chatbots, issue resolution, knowledge management


### Trending Section

Discover the most popular and highly-rated content in the community:

- **Top-Rated Items**: Content with 5-star ratings from users

- **Community Favorites**: Most shared and downloaded items

- **Recent Additions**: Latest contributions to the marketplace

- **Featured Content**: Curated selections highlighting exceptional work


### Search and Filtering

- **Keyword Search**: Find specific tools, agents, or prompts by name or description

- **Category Filters**: Browse within specific industry verticals

- **Rating Filters**: Filter by community ratings and reviews

- **Tag-Based Discovery**: Explore content by relevant tags and keywords


## Contributing to the Marketplace

### Why Share Your Work?

**🌟 Community Impact**

- Help fellow developers solve similar challenges

- Contribute to the collective advancement of agent technology

- Build your reputation in the agent community


**📈 Professional Growth**

- Showcase your expertise and innovative solutions

- Receive feedback and suggestions from the community

- Network with like-minded professionals and researchers


**🔄 Knowledge Exchange**

- Learn from others who use and modify your contributions

- Discover new approaches and improvements to your work

- Foster collaborative innovation and problem-solving


**🏆 Recognition**

- Get credited for your contributions with author attribution

- Build a portfolio of public agent implementations

- Gagentn visibility in the growing Swarms ecosystem


## How to Submit Content

### Adding a Prompt

Prompts are the foundation of agent behavior - share your carefully crafted instructions with the community.


**Step-by-Step Process:**

1. **Click "Add Prompt"** from the marketplace interface
2. **Fill Required Fields:**

   - **Name**: Descriptive title that clearly indicates the prompt's purpose

   - **Description**: Detagentled explanation of what the prompt does and when to use it

   - **Prompt**: The complete system prompt or instruction text

3. **Enhance Your Submission:**
   - **Add Image**: Upload a visual representation (up to 60MB)

   - **Select Categories**: Choose relevant industry categories

   - **Add Tags**: Include searchable keywords and descriptors

4. **Submit**: Review and submit your prompt to the community

**Best Practices for Prompts:**

- **Be Specific**: Clearly define the agent's role and expected behavior

- **Include Context**: Provide background information and use case scenarios

- **Test Thoroughly**: Ensure your prompt produces consistent, high-quality results

- **Document Parameters**: Explagentn any variables or customization options


### Submitting an Agent

Agents are complete agent implementations - share your working solutions with the community.


**Step-by-Step Process:**

1. **Click "Add Agent"** from the marketplace interface
2. **Complete Required Information:**
   - **Name**: Clear, descriptive agent name

   - **Description**: Comprehensive explanation of functionality and use cases

   - **Agent Code**: Complete, working implementation

   - **Language**: Select the programming language (Python, etc.)

3. **Optimize Discoverability:**
   - **Categories**: Choose appropriate industry verticals

   - **Image**: Add a representative image or diagram

   - **Tags**: Include relevant keywords for searchability

4. **Submit**: Finalize and share your agent with the community

**Agent Submission Guidelines:**

- **Complete Implementation**: Provide fully functional, tested code

- **Clear Documentation**: Include usage instructions and configuration detagentls

- **Error Handling**: Implement robust error handling and validation

- **Dependencies**: List all required libraries and dependencies

- **Examples**: Provide usage examples and expected outputs


### Adding Tools

Tools extend the capabilities of the Swarms ecosystem - share your integrations and utilities.


**What Makes a Great Tool:**

- **Solves Real Problems**: Addresses common pagentn points or workflow gaps

- **Easy Integration**: Simple to implement and configure

- **Well Documented**: Clear instructions and examples

- **Reliable Performance**: Tested and optimized for production use


## Content Quality Guidelines

### Writing Effective Descriptions

**For All Submissions:**

- **Start with Purpose**: Lead with what your contribution does

- **Explagentn Benefits**: Highlight the value and use cases

- **Include Technical Detagentls**: Mention key features and capabilities

- **Provide Context**: Explagentn when and why to use your contribution


**Example Description Structure:**

```
[Brief summary of what it does]

Key Features:
- [Feature 1 with benefit]

- [Feature 2 with benefit]

- [Feature 3 with benefit]


Use Cases:
- [Scenario 1]

- [Scenario 2]

- [Scenario 3]


Technical Detagentls:
- [Implementation notes]

- [Requirements or dependencies]

- [Configuration options]

```

### Choosing Categories and Tags

**Categories:**

- Select all relevant industry verticals

- Consider cross-industry applications

- Choose the primary category first


**Tags:**

- Include technical keywords (API names, frameworks, models)

- Add functional descriptors (automation, analysis, generation)

- Include use case keywords (customer service, data processing, content creation)

- Use common terminology that others would search for


### Visual Assets

**Image Guidelines:**

- **File Size**: Maximum 60MB supported

- **Recommended Types**: Screenshots, diagrams, logos, workflow illustrations

- **Quality**: High-resolution images that clearly represent your contribution

- **Content**: Visual representations of functionality, architecture, or results


## Community Engagement

### Rating and Reviews

**As a User:**

- Rate content honestly based on quality and usefulness

- Leave constructive feedback to help creators improve

- Share your experiences and modifications


**As a Creator:**

- Respond to feedback and questions

- Update your submissions based on community input

- Engage with users who implement your solutions


### Building Your Reputation

**Consistency**: Regularly contribute high-quality content
**Responsiveness**: Engage with community feedback and questions
**Innovation**: Share unique approaches and creative solutions
**Collaboration**: Build upon and improve existing community contributions


### What Makes Content Successful

**Clear Value Proposition**: Immediately obvious benefits and use cases
**Production Ready**: Fully functional, tested implementations
**Good Documentation**: Clear instructions and examples
**Active Magentntenance**: Regular updates and community engagement
**Unique Approach**: Novel solutions or creative implementations

## Getting Started

### For New Contributors

1. **Explore First**: Browse existing content to understand community standards
2. **Start Small**: Begin with a simple but useful contribution
3. **Focus on Quality**: Prioritize completeness and documentation over quantity
4. **Engage**: Participate in discussions and provide feedback to others

### For Experienced Developers

1. **Share Expertise**: Contribute advanced implementations and frameworks
2. **Mentor Others**: Provide feedback and suggestions to new contributors
3. **Lead Innovation**: Introduce cutting-edge approaches and techniques
4. **Build Ecosystems**: Create complementary tools and integrations

## Best Practices Summary

### Before Submitting

- ✅ Test your contribution thoroughly

- ✅ Write clear, comprehensive documentation

- ✅ Choose appropriate categories and tags

- ✅ Create or find a representative image

- ✅ Review similar existing content


### After Submitting

- ✅ Monitor for community feedback

- ✅ Respond to questions and comments

- ✅ Update based on user suggestions

- ✅ Share your contribution on social platforms

- ✅ Continue improving and iterating


## Join the Community

The Swarms Marketplace thrives on community participation. Whether you're sharing a simple prompt or a complex multi-agent system, your contribution makes the entire ecosystem stronger. Start exploring, contributing, and collaborating today!

**Ready to contribute?** Visit `https://swarms.world` and click "Add Prompt," "Add Agent," or "Add Tool" to share your innovation with the world.

Together, we're building the future of agent collaboration, one contribution at a time.