Agent skill

Cotal Setup

by Cotal-AI in Cotal-AI/Cotal

Set up Cotal on this machine: install it, start a local agent mesh (NATS + JetStream), verify it, and put an agent on it.

Apache-2.0Auto-check passedAgent Workflows

Install Cotal Setup

skills CLI
$ npx skills add Cotal-AI/Cotal --skill cotal-setup -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Cotal-AI/Cotal cotal-setup --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Cotal-AI/Cotal.git skills-src && mkdir -p .claude/skills && cp -r skills-src/website/public/.well-known/agent-skills/cotal-setup .claude/skills/cotal-setup && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
cotal-setup
GitHub stars
313
Token cost
~442 tokens
SKILL.md length
196 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
Apache-2.0

At a glance

Set up Cotal on this machine: install it, start a local agent mesh (NATS + JetStream), verify it, and put an agent on it.

  • Asked to install Cotal
  • SKILL.md covers Install and start, Verify, Put an agent on the mesh and If something fails, plus 1 more section
  • Calls npx
  • Join a Cotal mesh

What it does

Cotal Setup is an agent skill from Cotal-AI/Cotal. 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.

Its SKILL.md is about 440 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows. It works with Model Context Protocol. The repository describes itself as: The open standard for agent coordination. The licence is Apache-2.0.

When your agent uses it

  • Asked to install Cotal
  • Join a Cotal mesh
  • Let coding agents coordinate as peers

Example prompts

  • “/cotal-setup”

Requirements

  • Node.js

What it can do on your machine

Read from SKILL.md and the folder at commit bf3a7b2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • docs.cotal.ai

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Cotal Setup loads about 442 tokens when it runs. Until then it costs about 57 tokens; SKILL.md has 196 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~57
When it runs · the whole SKILL.md, loaded when a task matches
~442

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Cotal-AI/Cotal at commit bf3a7b2, republished under its Apache-2.0 licence (© Cotal-AI). 196 words, ~442 tokens.

Download SKILL.mdSave it as .claude/skills/cotal-setup/SKILL.md (or your agent's skills folder).
name
cotal-setup
description
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.

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 20+.

Install and start

sh
npx cotal-ai setup --yes     # configure only: seeds one agent, installs detected connectors, launches nothing
npx cotal-ai up --detach     # start the mesh + delivery daemon + manager

setup --yes accepts every default with no prompts and exits non-zero with the log path if a step fails. 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; OpenCode needs no install and auto-wires when spawned. The full tool surface is https://docs.cotal.ai/mcp-tools.md.

If something fails

  • The setup log is .cotal/setup.log; the server log is .cotal/nats.log.
  • Re-running npx cotal-ai setup --yes is safe; it keeps existing files.

When done

Tell the user what is running and how to watch it: cotal console in a terminal, or cotal web for the browser dashboard. For any follow-up task, route through https://docs.cotal.ai/llms.txt.

© Cotal-AI, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in website/public/.well-known/agent-skills/cotal-setup of Cotal-AI/Cotal.

Open the folder on GitHubat commit bf3a7b2

Compare with similar skills

Cotal Setup next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Cotal Setup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cotal Setup this skillCotal-AI/Cotal313—~442Automated safety check: PassApache-2.0
MCP Server Builderanthropics/skills180k63 repos~2.3kAutomated safety check: PassApache-2.0
MCP Server BuildershareAI-lab/learn-claude-code78k5 repos~1.2kAutomated safety check: PassMIT
MCP Integration for Pluginsanthropics/claude-plugins-official38k11 repos~3.1kAutomated safety check: PassApache-2.0
MemPalace Memory SearchMemPalace/mempalace59k—~1.4kAutomated safety check: PassMIT
Crush Configurationcharmbracelet/crush29k—~3.7kAutomated safety check: PassCustom licence

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 63 repos~2.3k tokens
    Agent WorkflowsAuto-check passed
  • MCP Server Builder

    shareAI-lab/learn-claude-code

    Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.

    78k GitHub starsUsed in 5 repos~1.2k tokens
    Agent WorkflowsAuto-check passed
  • MCP Integration for Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to bundle Model Context Protocol servers in a Claude Code plugin, covering config files, stdio, SSE, HTTP and WebSocket server types, and authentication.

    38k GitHub starsUsed in 11 repos~3.1k tokens
    Agent WorkflowsAuto-check passed
  • MemPalace Memory Search

    MemPalace/mempalace

    Mines project files and conversation exports into a local, searchable memory palace and recalls past work by semantic search through the mempalace CLI.

    59k GitHub stars~1.4k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed
  • Crush Configuration

    charmbracelet/crush

    Explains how to configure the Crush coding agent with crushrc or crush.json, covering providers, models, LSPs, MCP servers, hooks, permissions and config precedence.

    29k GitHub stars~3.7k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Context Mode Output Sandbox

    mksglu/context-mode

    Routes large command, file, API and browser output through context-mode tools so only the needed result enters the agent's context, instead of dumping it via Bash.

    26k GitHub stars~4.1k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed

More from Cotal-AI/Cotal

  • Pixel Face

    Cotal-AI/Cotal

    Create or improve a 32×32 pixel-art persona face for the Frontier Faces demo (examples/04-frontier-faces/personas.mjs) — the animated agent avatars rendered by face-term.mjs / the browser…

    313 GitHub stars~1.5k tokensUpdated yesterday
    Auto-check passed
  • Team Topology

    Cotal-AI/Cotal

    Define a multi-agent team for ANY task on ANY system as an explicit deployment topology - pick the shape from the task's dominant risk, specify the runtime/communication/trust layers, place model…

    313 GitHub stars~2.9k tokensUpdated yesterday
    Auto-check passed
  • Run several independent Cotal features concurrently by creating one Git worktree and one spawn-capable mesh manager per feature; each manager staffs a review panel in a dedicated channel, adds one…

    313 GitHub stars~5.3k tokensUpdated yesterday
    Auto-check passed
  • Cold Review

    Cotal-AI/Cotal

    Write the brief for a single independent cold reviewer and grade what it returns, keeping it isolated from the panel that already graded the change.

    313 GitHub stars~4.2k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Cotal Setup

What does Cotal Setup do?

Set up Cotal on this machine: install it, start a local agent mesh (NATS + JetStream), verify it, and put an agent on it. Cotal Setup is an agent skill from Cotal-AI/Cotal. Set up Cotal on this machine: install it, start a local agent mesh (NATS + JetStream), verify it, and put an agent on it.

When should I use Cotal Setup?

Cotal Setup fits situations like: asked to install Cotal; join a Cotal mesh; let coding agents coordinate as peers.

How do I install Cotal Setup in Claude Code?

Run `npx skills add Cotal-AI/Cotal --skill cotal-setup -a claude-code`. Or copy the skill folder (website/public/.well-known/agent-skills/cotal-setup in Cotal-AI/Cotal) into .claude/skills/cotal-setup in your project. Claude Code loads it when a task matches its description.

How do I install Cotal Setup in Codex?

Run `npx skills add Cotal-AI/Cotal --skill cotal-setup -a codex`. Or copy the skill folder (website/public/.well-known/agent-skills/cotal-setup in Cotal-AI/Cotal) into .agents/skills/cotal-setup in your project. Codex loads it when a task matches its description.

Can I use Cotal Setup in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Cotal-AI/Cotal --skill cotal-setup -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cotal-setup, .gemini/skills/cotal-setup, .github/skills/cotal-setup and .opencode/skills/cotal-setup in your project.

What does Cotal Setup need to run?

Going by SKILL.md and its folder, Cotal Setup needs the command-line tools its instructions call (npx). Our summary lists: Node.js.

Does Cotal Setup access the network?

SKILL.md names 1 domain. As links in the text: docs.cotal.ai. This is read from the text; nothing was executed.

Is Cotal Setup safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Cotal Setup use?

Cotal Setup is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Cotal Setup use?

About 442 tokens (SKILL.md is roughly 1.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Cotal Setup?

Skills that share tags, products or a category with Cotal Setup: MCP Server Builder (anthropics/skills, 180k stars), MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars), MCP Integration for Plugins (anthropics/claude-plugins-official, 38k stars) and MemPalace Memory Search (MemPalace/mempalace, 59k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cotal Setup?

Cotal-AI (a GitHub organization) maintains it in Cotal-AI/Cotal, which has 313 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 9, 2026.

Source: Cotal-AI/Cotal on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.