Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
patricio0312rev avatar

Using Workspaces

  • 1 installs
  • 9 repo stars
  • Updated January 25, 2026
  • patricio0312rev/workspaces

Overview and getting-started guide for the workspaces plugin that manages multiple related repositories for microservice or polyrepo setups.

About

Explains how to use the workspaces plugin to manage multiple related repositories, covering init, clone, setup, doctor and status commands. A developer uses it when getting started managing a multi-repo or polyrepo workflow.

  • Quick-start flow: init, clone, setup, doctor, status
  • Workspace configs stored under ~/.claude/workspaces/<name>/

Using Workspaces by the numbers

  • 1 all-time installs (skills.sh)
  • Ranked #2,476 of 3,282 Productivity & Planning skills by installs in the Skillselion catalog
  • Data as of Aug 4, 2026 (Skillselion catalog sync)
npx skills add https://github.com/patricio0312rev/workspaces --skill using-workspaces

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs1
repo stars9
Last updatedJanuary 25, 2026
Repositorypatricio0312rev/workspaces

What it does

Overview and getting-started guide for the workspaces plugin that manages multiple related repositories for microservice or polyrepo setups.

Files

SKILL.mdMarkdownGitHub ↗

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

1. Initialize a workspace: /workspaces:init

  • Creates a new workspace configuration
  • Add your projects with their repos, paths, and ports

2. Clone repositories: /workspaces:clone all

  • Clone all configured repos to their designated paths

3. Set up projects: /workspaces:setup all

  • Run setup scripts (install deps, migrations, etc.)

4. Verify everything: /workspaces:doctor

  • Check prerequisites and run health checks

5. 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

CommandDescription
/workspaces:initCreate a new workspace
/workspaces:statusShow status across all projects
/workspaces:cloneClone repositories
/workspaces:setupRun setup scripts
/workspaces:startStart services
/workspaces:stopStop services
/workspaces:affectedShow dependency graph
/workspaces:searchSearch across all projects
/workspaces:doctorCheck 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

Related skills

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.