Back to Skills

collab-cleanup

verified

Close out a collab session - archive or delete design artifacts

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-cleanup/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-cleanup/SKILL.md -a claude-code --skill collab-cleanup

Installation paths:

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

Instructions

# Collab Cleanup

## Browser-Based Questions

When a collab session is active, use `render_ui` for all user interactions.

**Component selection:**
| Question Type | Component |
|--------------|-----------|
| Yes/No | Card with action buttons |
| Choose 1 of 2-5 | RadioGroup |
| Choose 1 of 6+ | MultipleChoice |
| Free text | TextInput or TextArea |

**Example - Yes/No:**
```
Tool: mcp__plugin_mermaid-collab_mermaid__render_ui
Args: {
  "project": "<cwd>",
  "session": "<session>",
  "ui": {
    "type": "Card",
    "props": { "title": "<question context>" },
    "children": [{ "type": "Markdown", "props": { "content": "<question>" } }],
    "actions": [
      { "id": "yes", "label": "Yes", "primary": true },
      { "id": "no", "label": "No" }
    ]
  },
  "blocking": true
}
```

**Terminal prompts only when:** No collab session exists (pre-session selection).

## Overview

Close a collab session after development is complete. Offers choices to archive design artifacts, delete them, or keep the session open for reference.

**Announce at start:** "I'm using the collab-cleanup skill to close this session."

## Workflow

### Step 1: Identify Current Session

1. Call `mcp__plugin_mermaid-collab_mermaid__list_sessions` to get all sessions across projects:
   ```
   Tool: mcp__plugin_mermaid-collab_mermaid__list_sessions
   Args: {}
   ```
2. Filter results to current project (match `project` field against absolute cwd path)
3. If sessions found for current project:
   - For each session, fetch phase via `mcp__plugin_mermaid-collab_mermaid__get_session_state`:
     ```
     Tool: mcp__plugin_mermaid-collab_mermaid__get_session_state
     Args: { "project": "<cwd>", "session": "<session-name>" }
     ```
   - Display list with phases:
     ```
     Sessions in this project:
     1. glowing-sunny-mesa (phase: rough-draft)
     2. bright-calm-river (phase: implementation)
     ```
   - Ask: "Which session to clean up?" (or if only one, confirm it)
4. If no sessions for curre

Validation Details

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