Skill: Using Workspaces

Description

This skill provides an overview of the workspaces plugin and how to use it effectively for managing multi-project/multi-repo workflows.

Instructions

When the user asks about using the workspaces plugin, provide this overview:

Workspaces Overview

The workspaces plugin helps you manage multiple related repositories that belong to the same company or project. Perfect for teams working with microservices, polyrepos, or any multi-project setup.

Quick Start

•
Initialize a workspace: /workspaces:init
- •Creates a new workspace configuration
- •Add your projects with their repos, paths, and ports
•
Clone repositories: /workspaces:clone all
- •Clone all configured repos to their designated paths
•
Set up projects: /workspaces:setup all
- •Run setup scripts (install deps, migrations, etc.)
•
Verify everything: /workspaces:doctor
- •Check prerequisites and run health checks
•
Check status: /workspaces:status
- •See git status, branches, and running services across all projects

Configuration

Workspace configs are stored in ~/.claude/workspaces/<workspace-name>/:

•WORKSPACE.md - Main configuration with projects, relationships, and commands

Available Commands

Command	Description
`/workspaces:init`	Create a new workspace
`/workspaces:status`	Show status across all projects
`/workspaces:clone`	Clone repositories
`/workspaces:setup`	Run setup scripts
`/workspaces:start`	Start services
`/workspaces:stop`	Stop services
`/workspaces:affected`	Show dependency graph
`/workspaces:search`	Search across all projects
`/workspaces:doctor`	Check prerequisites and health

Tips

•Use /workspaces:affected api to see what depends on the API before making breaking changes
•Use /workspaces:search "TODO" to find TODOs across all projects
•Run /workspaces:doctor when something isn't working