Claude-code-templates 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.

install
source · Clone the upstream repo
git clone https://github.com/davila7/claude-code-templates
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/davila7/claude-code-templates "$T" && mkdir -p ~/.claude/skills && cp -r "$T/cli-tool/components/skills/ai-maestro/agent-messaging" ~/.claude/skills/davila7-claude-code-templates-agent-messaging && rm -rf "$T"
manifest: cli-tool/components/skills/ai-maestro/agent-messaging/SKILL.md
source content

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

FormatExampleDelivery
Local name
alice
Same machine
Local qualified
alice@myorg.aimaestro.local
Within mesh
External
alice@acme.crabmail.ai
Via provider (requires registration)

Core Commands

CommandDescription
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

TypeUse CasePriorityWhen
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