Claude Skill MartBrowse skillsQuick linesLearn by videoTerminal guideWhat is a Skill?
 
← Back to list

Agent Mail — Optional Coordination Adapter

A coordination adapter skill that keeps multiple AI writers from colliding in one repo using messages, acknowledgements, and TTL-bounded advisory file reservations.

AutomationAdvanced★ 445⑂ 41AI score 7/10Last updated: Sep 24, 2026

What it does

  • Coordinates multiple agents writing to the same repository so they don't overwrite each other.
  • Registers agent identities, sends/reads/acknowledges thread messages, and creates advisory file reservations with bounded TTLs.
  • On reservation conflicts, pending acknowledgements, or timeouts it reports facts and stops — never widens, renews, or force-releases on its own.
  • Explicitly bans the "silence-as-status" fallacy: no reply never means work is done or stalled.
  • Prefers MCP tools when present, otherwise the self-describing am CLI, pinning a single storage root to avoid database contention.

Who it's for

  • Teams running parallel Claude/agent sessions against one codebase
  • Developers building agent orchestration pipelines (AgentOps-style)
  • Workflows that need auditable handoffs and acknowledgement tracking between automated workers
  • Not needed for single-writer work — the skill tells you to skip it

Example uses

  1. Parallel refactor: Agent A reserves src/api/** for 30 minutes; Agent B's request returns the conflicting reservation as-is so a human decides the order.
  2. Handoff gate: Before advancing a declared transition, verify every ack-required message was acknowledged by its intended recipient; block the transition otherwise.
  3. Mailbox ownership diagnosis: When a daemon and the direct CLI contend for one storage root, it reports the lock owner and mode instead of restarting or repairing anything.

· · · Install guide · · ·

Try it now, no install

Paste this into Claude to use the skill without installing anything.

Read the instructions in this file and follow them to help me:
https://raw.githubusercontent.com/boshu2/agentops/HEAD/images/gemini/skills/agent-mail/SKILL.md

What I want: (describe your task here)

If Claude can't open the link, open it yourself and paste the contents instead.

↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.

Install in the Claude app (no terminal)
  1. Download the ZIP with the button below.
  2. In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
  3. Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
↓ Download ZIP
Install in Claude Code

Let Claude do it — paste this into Claude Code

Install the skill I found on Claude Skill Mart.
Copy the images/gemini/skills/agent-mail folder from the GitHub repo boshu2/agentops into my ~/.claude/skills/agent-mail/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/boshu2/agentops.git && mkdir -p ~/.claude/skills && cp -r agentops/images/gemini/skills/agent-mail ~/.claude/skills/

⚠ This is a third-party skill. Check the source repository before installing.

  1. Open a terminal.
  2. Clone the repo: git clone https://github.com/boshu2/agentops.git
  3. Create the skills folder: mkdir -p ~/.claude/skills
  4. Copy the skill: cp -r agentops/images/gemini/skills/agent-mail ~/.claude/skills/
  5. Confirm references/TOOLS.md, WORKFLOWS.md, and RECOVERY.md came along.
  6. This skill requires an Agent Mail runtime: connect its MCP server or install the am CLI, then verify with am mail --help.
  7. Restart Claude Code and try: "Use the agent-mail skill to coordinate file reservations between two writers."
  8. Caution: clear-and-reset-everything irreversibly deletes the database and all storage — only run it with an explicit destructive-reset authorization.
View source on GitHub ↗License: Apache-2.0