agent-messaging

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.

24,269 stars

Best use case

agent-messaging is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

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.

Teams using agent-messaging should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/agent-messaging/SKILL.md --create-dirs "https://raw.githubusercontent.com/davila7/claude-code-templates/main/cli-tool/components/skills/ai-maestro/agent-messaging/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/agent-messaging/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How agent-messaging Compares

Feature / Agentagent-messagingStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

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.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

SKILL.md Source

# 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 | `alice@myorg.aimaestro.local` | Within mesh |
| External | `alice@acme.crabmail.ai` | 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

async-python-patterns

24269
from davila7/claude-code-templates

Comprehensive guidance for implementing asynchronous Python applications using asyncio, concurrent programming patterns, and async/await for building high-performance, non-blocking systems.

slack-automation

24269
from davila7/claude-code-templates

Automate Slack workspace operations including messaging, search, channel management, and reaction workflows through Composio's Slack toolkit.

linear-automation

24269
from davila7/claude-code-templates

Automate Linear tasks via Rube MCP (Composio): issues, projects, cycles, teams, labels. Always search tools first for current schemas.

jira-automation

24269
from davila7/claude-code-templates

Automate Jira tasks via Rube MCP (Composio): issues, projects, sprints, boards, comments, users. Always search tools first for current schemas.

gitops-workflow

24269
from davila7/claude-code-templates

Complete guide to implementing GitOps workflows with ArgoCD and Flux for automated Kubernetes deployments.

github-automation

24269
from davila7/claude-code-templates

Automate GitHub repositories, issues, pull requests, branches, CI/CD, and permissions via Rube MCP (Composio). Manage code workflows, review PRs, search code, and handle deployments programmatically.

github-actions-templates

24269
from davila7/claude-code-templates

Production-ready GitHub Actions workflow patterns for testing, building, and deploying applications.

zustand-store-ts

24269
from davila7/claude-code-templates

Create Zustand stores following established patterns with proper TypeScript types and middleware.

zod-validation-expert

24269
from davila7/claude-code-templates

Expert in Zod — TypeScript-first schema validation. Covers parsing, custom errors, refinements, type inference, and integration with React Hook Form, Next.js, and tRPC.

tanstack-query-expert

24269
from davila7/claude-code-templates

Expert in TanStack Query (React Query) — asynchronous state management. Covers data fetching, stale time configuration, mutations, optimistic updates, and Next.js App Router (SSR) integration.

tailwind-design-system

24269
from davila7/claude-code-templates

Build production-ready design systems with Tailwind CSS, including design tokens, component variants, responsive patterns, and accessibility.

sveltekit

24269
from davila7/claude-code-templates

Build full-stack web applications with SvelteKit — file-based routing, SSR, SSG, API routes, and form actions in one framework.