agent-messaging

AI Community

Repo stars 27,504
Author repo claude-code-templates

Interpretation is structured for decision-making; original keeps the upstream SKILL.md unchanged.

Decide Fit First

Core job: Send and receive cryptographically signed messages between AI agents using the Agent Messaging Protocol (AMP). Use when the user…
Best fit: Use it when the task has reusable inputs, steps, and validation criteria rather than a one-off answer.
Avoid forcing it: If the source lacks commands, platform support, or external-service evidence, keep those fields unknown instead of guessing.

Design Intent

Structure: The skill is organized around “Prerequisites”, “Quick Start”, “1. Initialize identity (first time)”, “2. Send a message”, showing how the author expects the agent to judge fit, collect context, and produce verifiable output.
Trigger evidence: Prioritize the author’s wording around when to use it, what context to collect, and what output shape to produce.
Evidence boundary: Author text states facts, repository files prove commands and paths, and Fluxly only adds fit, limits, and usage judgment.

How To Use It

Inputs: Provide target material, scope, expected result, forbidden changes, and validation method.
Invocation: Name agent-messaging directly; if the source includes slash commands, start with the command and then add task context.
Validation: Start small and check whether the result follows “Prerequisites / Quick Start / 1. Initialize identity (first time)” before expanding.

Boundaries And Review

Dependencies: It usually needs no extra API key, so start with a small validation task.
Permissions: Declared permissions include read / write; ask the agent to state file, command, and rollback boundaries before acting.
Quality bar: A useful result names the deliverable, evidence, and next action. Generic prose means the task needs tighter context.

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	`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

# 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

Fluxly profile Author and license come from source; runtime, permissions, and network are Fluxly detections or estimates

Fluxly category: AI
Author-declared agents: No explicit declaration found; this is not inferred or tested compatibility
Static check: 88 / 100 · heuristic scan, not runtime safety proof
Author / version / license: @davila7 · no license declared
Fluxly token estimate: Lean
Fluxly setup estimate: Plug-and-play
External API key: No requirement detected
Detected OS requirements: Unspecified
Runtime requirements: Unspecified
Detected file/system behavior: Read-only
Write / modify
Detected network behavior: Local-only
Install commands: None (reference only)

Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.

Heads up: 未限定 allowed-tools，默认拥有全部工具权限。

Output preview agent-messaging.preview

The current SKILL.md does not define a fixed output example.

SKILL.md SKILL.md

# 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

…

Evidence boundary and execution chain

Author text anchors workflow facts; Fluxly only indexes current sections, terms, files, and commands.

sections -> Prerequisites → Quick Start → 1. Initialize identity (first time) → 2. Send a message → 3. Check inbox → 4. Read a message
terms    -> locally by default · Ed25519 signatures · Private keys stay local · Per-agent identity · federation with external providers · push notifications · attachment scanning · 5 more skills
files/cmd -> ~/.local/bin/ · alice · alice@myorg.aimaestro.local · alice@acme.crabmail.ai · amp-init --auto · amp-send <to> <subject> <body> · amp-inbox · --all
body sha256 -> 27ba8ad95118