cotal-mesh SKILL.md skillA

cotal-mesh from cotal-ai/cotal is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add cotal-ai/cotal/cotal-mesh@git:20261026.e22a38a

Pins git:20261026.e22a38a in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
cotal-ai/cotal
Path
skills/cotal-mesh/SKILL.md
Versions recorded
2
Latest version
git:20261026.e22a38a, committed Oct 26, 2026
First version recorded
Sep 7, 2026
Size
3,853 bytes
Repository stars
380
License
Apache-2.0

Put an AI agent on a Cotal mesh and coordinate with other agents across vendors and machines. Use when a user runs two or more agents that must hand work to each other, share a durable record, or spawn teammates; covers install, starting a local mesh, joining, messaging peers, and using the cotal.ai site API and MCP server for feedback, the Cotal Cloud waitlist, and the build log.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# COTAL mesh

COTAL is an open protocol (Apache-2.0, self-hosted, any framework) that lets AI agents from any vendor work as one team: one shared space where agents discover each other by name, channel or role, divide the work, and keep a durable, replayable record. Transport is NATS + JetStream; the spec is the wire contract and the libraries are thin clients.

## When to use this skill

- You run two or more AI agents — from the same vendor or different ones (Claude Code, OpenCode, Hermes, Codex, custom frameworks) — that need to hand work to each other, share state, or wake each other up.
- You need one durable, replayable record of who did what across a fleet, on infrastructure you control (self-hosted, Apache-2.0).
- You want agents to discover each other by name, channel or role and to spawn their own teammates, without a central orchestrator.
- Your agents run on different machines (laptops, CI runners, cloud VMs, on-prem) and should behave as one team.

Not for a single agent that only needs tools (plain MCP covers that).

## Put yourself on a local mesh

The authoritative runbook is https://docs.cotal.ai/prompt.md. Fetch it and run its steps; the summary:
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add cotal-ai/cotal/cotal-mesh@sha256:15b5b719604f29f9

The line at the top of this page pins the label git:20261026.e22a38a, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_purjm6c7sjrerr3e.svg)](https://markdownregistry.com/a/art_purjm6c7sjrerr3e)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between Sep 7, 2026 and Oct 26, 2026, about one every 49 days. Its first recorded version is graded B and its latest A.

versioncommittedcommitsizeaudit
git:20261026.e22a38a latest2026-10-26 e22a38a 3,853 BA view · diff
git:20260907.da4d3cb2026-09-07 da4d3cb 3,631 BB view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (3853 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

cotal-ai/cotal · 380 stars · license Apache-2.0 · pushed 2026-11-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_purjm6c7sjrerr3e
GET https://markdownregistry.com/api/v1/resolve?ref=cotal-ai/cotal/cotal-mesh
GET https://markdownregistry.com/api/v1/blob/15b5b719604f29f947873da75449faed2fac7050cd4d5f6f45ef48a5d0409b65

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from cotal-ai/cotal

cold-review SKILL.md skill
cotal-ai/cotal · .claude/skills/cold-review/SKILL.md · Write the brief for a single independent cold reviewer and grade what it returns, keeping it isolated from the panel…
git:20260828.4605050 · audit A · 380 stars
parallel-feature-managers SKILL.md skill
cotal-ai/cotal · .claude/skills/parallel-feature-managers/SKILL.md · Run several independent Cotal features concurrently by creating one Git worktree and one spawn-capable mesh manager per…
git:20261101.13499c0 · audit A · 380 stars
pixel-face SKILL.md skill
cotal-ai/cotal · .claude/skills/pixel-face/SKILL.md · Create or improve a 32×32 pixel-art persona face for the Frontier Faces demo (examples/04-frontier-faces/personas.mjs)…
git:20260630.58d0aa6 · audit A · 380 stars
AGENTS.md AGENTS.md file
cotal-ai/cotal · AGENTS.md
git:20261104.5d6a29a · audit A · 380 stars
CLAUDE.md CLAUDE.md file
cotal-ai/cotal · CLAUDE.md
git:20260619.3e93e9b · audit B · 380 stars
team-topology SKILL.md skill
cotal-ai/cotal · claude-plugin/cotal-skills/skills/team-topology/SKILL.md · Define a multi-agent team for ANY task on ANY system as an explicit deployment topology - pick the shape from the…
git:20261004.8a9d279 · audit A · 380 stars
team-topology SKILL.md skill
cotal-ai/cotal · implementations/cli/cotal-skills/skills/team-topology/SKILL.md · Define a multi-agent team for ANY task on ANY system as an explicit deployment topology - pick the shape from the…
git:20260813.2ba90d1 · audit A · 380 stars
llms.txt llms.txt file
cotal-ai/cotal · llms.txt
git:20261101.13499c0 · audit A · 380 stars
cotal-setup SKILL.md skill
cotal-ai/cotal · website/public/.well-known/agent-skills/cotal-setup/SKILL.md · Set up Cotal on this machine: install it, start a local agent mesh (NATS + JetStream), verify it, and put an agent on…
git:20261026.e22a38a · audit A · 380 stars

Every file in cotal-ai/cotal

Browse by kind, by grade A, or by owner.