collab

Start or resume collaborative sessions in Claude Code with routing.

Updated Jan 12, 2026
One-click install
npx skills add https://github.com/ben-mad-jlp/claude-mermaid-collab --skill collab
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: collab
Source: https://github.com/ben-mad-jlp/claude-mermaid-collab/tree/main/skills/collab
Command: npx skills add https://github.com/ben-mad-jlp/claude-mermaid-collab --skill collab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill simplifies starting and resuming collaborative sessions inside Claude Code, ensuring the collaboration server is healthy, sessions are easy to find or create, and routing to the correct workflow occurs automatically.

Core Features & Use Cases

  • Health-checks and session discovery for collaborative work.
  • Create new sessions or resume existing ones with a chosen type (Structured or Vibe).
  • Stateful routing to the next skill in the collab workflow, handling transitions between phases.

Quick Start

Start or resume a collab session by invoking the /collab command in Claude Code. If the server is not running, start the Mermaid Collab server from the plugin path and then re-run the /collab command. When prompted, choose Create New or an existing session and select the type: Structured (guided workflow) or Vibe (freeform).

Frequently Asked Questions about collab

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I start a collaboration session inside Claude Code?

To start a collaboration session inside Claude Code, invoke the /collab command, ensure the Mermaid Collab server is running, and choose to create a new session by selecting either a Structured guided workflow or a freeform Vibe mode.

What is the difference between Structured and Vibe workflow modes?

Structured workflow mode provides a guided, stateful routing process through predefined phases, whereas Vibe mode enables freeform collaboration, allowing users to bypass the guided state-machine and work without strict phase transitions.

How do I resume an existing collaboration session in Claude Code?

Resuming an existing collaboration session requires invoking the /collab command to trigger session discovery, which identifies active sessions on the Mermaid Collab server and routes you back into the chosen stateful workflow.

Why does the /collab command fail to initialize a session?

The /collab command fails to initialize a session if the Mermaid Collab server is not running or fails its health check, requiring you to manually start the server from the plugin path before re-running the command.

Does Claude Code session management require a dedicated collaboration server?

Yes, Claude Code session management requires integration with the Mermaid Collab server to perform server health checks, manage session discovery, and execute stateful routing for initializing or resuming collaborative workflows.

Can I manage stateful workflow routing without a guided workflow?

Yes, you can manage stateful workflow routing without a guided workflow by selecting Vibe mode during session creation, which provides freeform collaboration while still supporting underlying state transitions between phases.