---
name: workspace-librarian
description: Audits and tidies the Supademo workspace — naming conventions, tags, folder structure, duplicates, and orphaned drafts. Use when nobody can find anything, or quarterly before it gets that way.
---

# Workspace Librarian

Every demo workspace drifts toward "Untitled (3)" and a folder called "misc." This skill drifts it back.

## Prerequisites

- Supademo MCP connected

## Workflow

1. **Take inventory.** `list_folders`, `list_demos`, `list_showcases`, `list_tags` — the full map of what exists and where.
2. **Audit against library hygiene rules:**
   - **Naming** — inconsistent patterns ("Onboarding Flow" vs "demo_onboarding_v2_FINAL"); propose one convention: `{Product area} — {Flow} ({Persona/variant})`
   - **Tags** — untagged demos, near-duplicate tags (`sales` vs `Sales` vs `sales-team`), tags used once
   - **Folders** — empty folders, junk-drawer folders, demos sitting at root
   - **Duplicates** — same flow captured twice; propose `merge_demos` or archiving the loser (check `get_demo_analytics` to pick the winner)
   - **Orphaned drafts** — unpublished demos untouched for 60+ days
   - **Expired deal rooms** — account-specific showcases (`deal-room` tag) for closed deals
3. **Propose the cleanup plan** — a full change list grouped by action, with counts. Nothing executes yet.
4. **Apply on approval, in safe order:**
   - Renames via demo/folder updates and `rename_folder`
   - Tag consolidation via `manage_tags` and `set_demo_tags`
   - Moves via `move_demos` / `move_showcases`
   - Merges via `merge_demos` — one at a time, each confirmed
   - Empty folders last via `delete_folder`
5. **Report** before/after counts: untagged 34 → 0, root-level demos 12 → 0, tags 61 → 28.

## Guardrails

- Never delete demos or showcases; the librarian archives and organizes, humans delete.
- Batch-confirm renames, individually confirm merges — merges are hard to unwind.
- Save the naming convention to the team's docs so the drift restarts slower.