Back to Skills

collab-start

verified

Start the mermaid-collab server and begin a collab session

View on GitHub

Marketplace

mermaid-collab-dev

ben-mad-jlp/claude-mermaid-collab

Plugin

mermaid-collab

Repository

ben-mad-jlp/claude-mermaid-collab

skills/collab-start/SKILL.md

Last Verified

January 25, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/ben-mad-jlp/claude-mermaid-collab/blob/main/skills/collab-start/SKILL.md -a claude-code --skill collab-start

Installation paths:

Claude
.claude/skills/collab-start/
Powered by add-skill CLI

Instructions

# Start Collab

Quick-start command that ensures the server is running and launches a collab session.

---

## Step 1: Check Server Status

```bash
curl -s http://localhost:3737 > /dev/null 2>&1 && echo "running" || echo "not running"
```

---

## Step 2: Start Server If Needed

**If not running:**

Get the plugin install path and start the server:

```bash
bun run <plugin-path>/bin/mermaid-collab.ts start
```

Where `<plugin-path>` is the directory containing this skill (the plugin root).

To find the plugin path, use the path of this skill file and go up two directories:
- This skill is at: `<plugin-path>/skills/collab-start/SKILL.md`
- Plugin root is: `<plugin-path>/`

Wait for server to start (the CLI will confirm).

**If already running:** Continue to Step 3.

---

## Step 3: Invoke Collab Skill

```
Invoke skill: collab
```

This hands off to the collab skill which will:
- Show existing sessions or create a new one
- Guide through the full collab workflow

---

## Notes

- This is a convenience command combining server startup + collab workflow
- The server runs in background and persists across sessions
- Use `bun run <plugin-path>/bin/mermaid-collab.ts stop` to stop the server manually

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
1192 chars