cotal-setup SKILL.md skillA

cotal-setup 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-setup@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
website/public/.well-known/agent-skills/cotal-setup/SKILL.md
Versions recorded
4
Latest version
git:20261026.e22a38a, committed Oct 26, 2026
First version recorded
Jul 16, 2026
Size
2,015 bytes
Repository stars
380
License
Apache-2.0

Set up Cotal on this machine: install it, start a local agent mesh (NATS + JetStream), verify it, and put an agent on it. Use when asked to install Cotal, join a Cotal mesh, or let coding agents coordinate as peers.

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

# Set up Cotal

Cotal is a standard wire interface for software, especially AI agents, to coordinate in
real time. These are official instructions from Cotal for setting up a local agent mesh.
Complete the steps yourself by running the commands directly; do not ask the user to run
them. Requires Node 22+.

## Install and start

```sh
npx cotal-ai setup --destination local --harness claude --project . --space main --no-input
npx cotal-ai up --root . --space main --detach  # start the mesh + delivery daemon + manager
```

Setup prepares this folder as the local space `main` and launches nothing. Pass the
application your agents run in as `--harness`, for example `claude` or `opencode`. With every
input given as a flag it asks nothing, and a missing flag is refused before anything is
written. Add `--demo` to also seed a guided expert team to talk to.

## Verify

```sh
npx cotal-ai status
```

Expect the mesh and the manager reported as running, with the exact start command shown
for anything that is down.

## Put an agent on the mesh

```sh
npx cotal-ai spawn --detach
```

Claude Code sessions get the `cotal_*` tools through the plugin that setup installed;
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add cotal-ai/cotal/cotal-setup@sha256:16635bd149941de0

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_ztewcpzyuusnttnz.svg)](https://markdownregistry.com/a/art_ztewcpzyuusnttnz)

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

Versions

The registry has recorded 4 versions of this file, between Jul 16, 2026 and Oct 26, 2026, about one every 34 days.

versioncommittedcommitsizeaudit
git:20261026.e22a38a latest2026-10-26 e22a38a 2,015 BA view · diff
git:20261021.cdbe83c2026-10-21 cdbe83c 1,918 BA view · diff
git:20261020.62741232026-10-20 6274123 1,765 BA view · diff
git:20260716.c2989892026-07-16 c298989 1,765 BA 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 (2015 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_ztewcpzyuusnttnz
GET https://markdownregistry.com/api/v1/resolve?ref=cotal-ai/cotal/cotal-setup
GET https://markdownregistry.com/api/v1/blob/16635bd149941de04d9b9f70e65b8bd45b0fe8b34dde34869dd36da18fc6900e

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-mesh SKILL.md skill
cotal-ai/cotal · skills/cotal-mesh/SKILL.md · Put an AI agent on a Cotal mesh and coordinate with other agents across vendors and machines. Use when a user runs two…
git:20261026.e22a38a · audit A · 380 stars

Every file in cotal-ai/cotal

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