team-collab

---

Why This Exists

When a team leans on AI coding agents, work slips through the cracks between sessions: nobody is sure what state the project is in, who owns which TODO, why a past decision was made, or what the last session actually did. Handoffs turn into scrolling back through old chat logs.

team-collab-skills gives your agents a shared, file-based routine so any agent — or teammate — can pick up where the last one left off:

• A few status files as the single source of truth — CURRENT.md (where things stand), NEXT.md (what's next), RISKS.md, and TODO.md. Everything important lives in the repo, not in a chat window.
• Simple session commands — $checkpoint to save progress mid-task, $handoff to wrap up a session, $team-progress to see what teammates did recently, and $docs-refresh to bring stale docs back up to date.
• Clear TODO ownership — a TODO can be claimed with @owner so two agents don't grab the same task at once.
• Sensible git habits — code changes go through pull/merge requests, shared docs go through their own doc PRs, and personal working notes stay in your own folder.
• Readable status docs — the status files are kept short and current instead of growing into an endless changelog.
• Works across tools — a native plugin for Claude Code and Codex, plus thin adapter files for Cursor, VS Code, Cline, OpenCode, Continue, and Gemini CLI.
• Multi-agent collaboration (v0.2.0+) — several agents can work one batch of tasks (a wave) at the same time, coordinating entirely through committed files. See Multi-Agent Collaboration below.

This repository is the source of truth that agents actually load at runtime: the skills, protocol references, adapters, and manifests. A companion command-line tool, @embodot/collab, is published on npm and adds an installer, health checks, and the multi-agent commands.

---

Quick Start

Claude Code

claude plugin marketplace add dadwadw233/team-collab-skills
claude plugin install team-collab@team-collab-skills

Claude loads the protocol automatically when it sees a clear team-project signal — for example an obsidian-docs/ folder, a project AGENTS.md, references to CURRENT/NEXT/RISKS/TODO, or a direct request like "do a handoff".

Codex CLI

codex plugin marketplace add https://github.com/dadwadw233/team-collab-skills.git

Then use the entrypoints:

$checkpoint
$handoff <topic>
$team-progress 24h
$docs-refresh <audit-doc-or-topic>

If Codex passes /handoff, /checkpoint, /team-progress, or /docs-refresh through as plain text, treat it the same as the $... form.

With the CLI (optional)

If you also use the @embodot/collab command-line tool, it can install these skills for every agent at once and check your setup:

npm install -g @embodot/collab@latest
team-collab install-skills --agent all --force
team-collab doctor --project <project>

---

Adapter Matrix

Adapter files are deliberately thin pointers back to the protocol — don't copy the full protocol into each tool's rule file. The source of truth is skills/protocol/.