Development

Agent Messaging

Version1.0.0

LicenseMIT

Token count~807

UpdatedMay 27, 2026

Send and receive cryptographically signed messages between AI agents using the Agent Messaging Protocol (AMP). Use when the user asks to "send a message to an agent", "check agent inbox", "message another agent", "reply to a message", "notify an agent", or any inter-agent communication task.

Install

Quick install

via npx skills · works with 57+ agents

npx skills add https://github.com/davila7/claude-code-templates/tree/main/cli-tool/components/skills/ai-maestro/agent-messaging

Or pick agent:

npx skills add davila7/claude-code-templates --skill agent-messaging --agent claude-code

npx skills add davila7/claude-code-templates --skill agent-messaging --agent cursor

npx skills add davila7/claude-code-templates --skill agent-messaging --agent codex

npx skills add davila7/claude-code-templates --skill agent-messaging --agent opencode

npx skills add davila7/claude-code-templates --skill agent-messaging --agent github-copilot

npx skills add davila7/claude-code-templates --skill agent-messaging --agent windsurf

More install options

Shorthand — useful for multi-skill repos:

npx skills add davila7/claude-code-templates --skill agent-messaging

Manual — clone the repo and drop the folder into your agent's skills directory:

git clone https://github.com/davila7/claude-code-templates.git

cp -r claude-code-templates/cli-tool/components/skills/ai-maestro/agent-messaging ~/.claude/skills/

How to use: Once installed, ask your agent to "use the agent-messaging skill" or describe what you want (e.g. "Send and receive cryptographically signed messages between AI agents using the A"). Requires Node.js 18+.

Agent Messaging Protocol (AMP)

Send and receive cryptographically signed messages between AI agents. AMP works locally by default -- no external dependencies needed for basic messaging. Part of the AI Maestro suite.

Prerequisites

Install the AMP CLI scripts:

# From the AI Maestro plugin
git clone https://github.com/23blocks-OS/ai-maestro-plugins.git
cd ai-maestro-plugins && ./install-messaging.sh -y

Scripts install to ~/.local/bin/ (ensure it's in your PATH).

Quick Start

1. Initialize identity (first time)

amp-init --auto

2. Send a message

amp-send alice "Hello" "How are you?"

3. Check inbox

amp-inbox

4. Read a message

amp-read <message-id>

5. Reply

amp-reply <message-id> "Got it, working on it now"

Address Formats

| Format | Example | Delivery |
|--------|---------|----------|
| Local name | alice | Same machine |
| Local qualified | [email protected] | Within mesh |
| External | [email protected] | Via provider (requires registration) |

Core Commands

| Command | Description |
|---------|-------------|
| amp-init --auto | Create agent identity |
| amp-send <to> <subject> <body> | Send a message |
| amp-inbox | Check inbox (add --all for read messages) |
| amp-read <id> | Read a specific message |
| amp-reply <id> <body> | Reply to a message |
| amp-delete <id> | Delete a message |
| amp-status | Show identity and registrations |
| amp-identity | Show current identity |

Message Options

# Set priority
amp-send alice "Deploy" "Ready for prod" --priority urgent

# Set type
amp-send alice "Review PR #42" "Please review" --type request

# Attach files
amp-send alice "Report" "See attached" --attach report.pdf

Message Types and Priorities

| Type | Use Case | | Priority | When |
|------|----------|-|----------|------|
| notification | General info (default) | | normal | Standard (default) |
| request | Asking for something | | urgent | Immediate attention |
| task | Assigned work | | high | Respond soon |
| handoff | Transferring context | | low | When convenient |
| status | Progress update | | | |

Security

Ed25519 signatures on every message
Private keys stay local -- never sent to providers
Per-agent identity -- each agent has unique keypair

Full AI Maestro Experience

This skill provides basic AMP messaging. For the complete experience including federation with external providers, push notifications, attachment scanning, and 5 more skills (memory search, docs search, graph query, planning, agent management), install the full AI Maestro platform.

Protocol spec: agentmessaging.org

SKILL.md source

---
name: agent-messaging
description: Send and receive cryptographically signed messages between AI agents using the Agent Messaging Protocol (AMP). Use when the user asks to "send a message to an agent", "check agent inbox", "message ...
---

# Agent Messaging Protocol (AMP)

Send and receive cryptographically signed messages between AI agents. AMP works **locally by default** -- no external dependencies needed for basic messaging. Part of the [AI Maestro](https://github.com/23blocks-OS/ai-maestro) suite.

## Prerequisites

Install the AMP CLI scripts:
```bash
# From the AI Maestro plugin
git clone https://github.com/23blocks-OS/ai-maestro-plugins.git
cd ai-maestro-plugins && ./install-messaging.sh -y
```

Scripts install to `~/.local/bin/` (ensure it's in your PATH).

## Quick Start

### 1. Initialize identity (first time)
```bash
amp-init --auto
```

### 2. Send a message
```bash
amp-send alice "Hello" "How are you?"
```

### 3. Check inbox
```bash
amp-inbox
```

### 4. Read a message
```bash
amp-read <message-id>
```

### 5. Reply
```bash
amp-reply <message-id> "Got it, working on it now"
```

## Address Formats

| Format | Example | Delivery |
|--------|---------|----------|
| Local name | `alice` | Same machine |
| Local qualified | `[email protected]` | Within mesh |
| External | `[email protected]` | Via provider (requires registration) |

## Core Commands

| Command | Description |
|---------|-------------|
| `amp-init --auto` | Create agent identity |
| `amp-send <to> <subject> <body>` | Send a message |
| `amp-inbox` | Check inbox (add `--all` for read messages) |
| `amp-read <id>` | Read a specific message |
| `amp-reply <id> <body>` | Reply to a message |
| `amp-delete <id>` | Delete a message |
| `amp-status` | Show identity and registrations |
| `amp-identity` | Show current identity |

## Message Options

```bash
# Set priority
amp-send alice "Deploy" "Ready for prod" --priority urgent

# Set type
amp-send alice "Review PR #42" "Please review" --type request

# Attach files
amp-send alice "Report" "See attached" --attach report.pdf
```

## Message Types and Priorities

| Type | Use Case | | Priority | When |
|------|----------|-|----------|------|
| `notification` | General info (default) | | `normal` | Standard (default) |
| `request` | Asking for something | | `urgent` | Immediate attention |
| `task` | Assigned work | | `high` | Respond soon |
| `handoff` | Transferring context | | `low` | When convenient |
| `status` | Progress update | | | |

## Security

- **Ed25519 signatures** on every message
- **Private keys stay local** -- never sent to providers
- **Per-agent identity** -- each agent has unique keypair

## Full AI Maestro Experience

This skill provides basic AMP messaging. For the complete experience including **federation with external providers**, **push notifications**, **attachment scanning**, and **5 more skills** (memory search, docs search, graph query, planning, agent management), install the full [AI Maestro](https://github.com/23blocks-OS/ai-maestro) platform.

Protocol spec: [agentmessaging.org](https://agentmessaging.org)

Related skills 6

ElevenLabs Automation

★ Featured

Automate ElevenLabs text-to-speech workflows -- generate speech from text, browse and inspect voices, check subscription limits, list models, stream audio, and retrieve history via the Composio MCP...

ComposioHQ 46

Development

Finishing A Development Branch

★ Featured Official

Use when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for merge, PR, or cleanup

obra 45

Development

Receiving Code Review

★ Featured Official

Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performat...

obra 45

Development

Webapp Testing

★ Featured

Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browse...

ComposioHQ 40

Development

Replicate Automation

★ Featured

Automate Replicate AI model operations -- run predictions, upload files, inspect model schemas, list versions, and manage prediction history via the Composio MCP integration.

ComposioHQ 38

Development

OpenAI Automation

★ Featured

Automate OpenAI API operations -- generate responses with multimodal and structured output support, create embeddings, generate images, and list models via the Composio MCP integration.

ComposioHQ 36

Development