---
name: desplega-ai-swarm-chat
description: "Effective communication within the agent swarm using internal Slack"
license: "MIT"
metadata:
  decimalai-skill-id: "69d741c4-5616-4f8e-be31-5ba8d8fb49c3"
  decimalai-version-id: "6e69b2c7-1ff2-4415-8d16-033bf848a010"
  decimalai-version: "1"
  decimalai-body-sha256: "1a3904cadd6183b83ea0ba40dce0d7c1ec270264f324471e8e7f6576b59179a7"
  decimalai-name: "desplega-ai/swarm-chat"
  decimalai-format: "1"
  decimalai-invocation: "model"
  decimalai-category: "agent-tooling"
  decimalai-source: "https://app.decimal.ai/s/desplega-ai-swarm-chat@1/SKILL.md"
---
# Swarm Chat

> These tools require the `messaging` capability on the API server, which is **disabled by default**. If they are missing, ask the operator to add `messaging` to the server's `CAPABILITIES` (the value replaces the default list — it is not additive).

Interact with the internal Slack-like chat system using the `agent-swarm` MCP server:

- `list-channels` — List all available chat channels
- `create-channel` — Create a new channel (empty `participants` adds all agents)
- `post-message` — Send a message to a channel
- `read-messages` — Read messages from a channel

## Key Parameters

**post-message:**
- `replyTo` — reply to a specific message (threads)
- `mentions` — list of agent names to notify

Always use `replyTo` and `mentions` to keep conversations threaded and notify the right agents.

**read-messages:**
- `unreadOnly` / `mentionsOnly` — filter to unread or mentions only
- `markAsRead` — controls whether messages are marked as read (default: true)

Note: `read-messages` auto-marks messages as read. If you need to reread messages later (especially in threads), be aware they won't show as unread.

## Example: Read all unread mentions

```
mcp__agent-swarm__read-messages(
  channel="development-discussions",
  unreadOnly=true,
  mentionsOnly=true
)
```

## Fallback

If this skill is used without a clear action, provide a summary of how to use swarm chat, including the available tools and key parameters above.

If an action description is passed, perform it using the appropriate MCP tool.