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

Workspace Doctor

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

Checks workspace prerequisites, verifies required tools, and runs health checks for workspace services from WORKSPACE.md.

About

Verifies prerequisites and required tools then runs health checks for workspace services defined in WORKSPACE.md. A developer uses it to confirm a multi-repo workspace is correctly set up and healthy.

  • Parses Prerequisites and Health Checks sections from WORKSPACE.md
  • Verifies git, curl/wget and jq availability

Workspace Doctor by the numbers

  • 1 all-time installs (skills.sh)
  • Ranked #2,479 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 workspace-doctor

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

Checks workspace prerequisites, verifies required tools, and runs health checks for workspace services from WORKSPACE.md.

Files

SKILL.mdMarkdownGitHub ↗

Skill: Workspace Doctor

Description

Check prerequisites, verify installations, and run health checks for workspace services.

Instructions

When the user wants to check workspace health:

Step 1: Check Prerequisites

Parse the ## Prerequisites section from WORKSPACE.md:

## Prerequisites
- Node.js 20+
- Docker & Docker Compose
- PostgreSQL 15+ (or use Docker)

Verify each prerequisite is installed and meets version requirements.

Step 2: Check Required Tools

Always verify these tools are available:

  • git - Version control
  • curl or wget - HTTP requests
  • jq - JSON processing (optional but recommended)

Step 3: Run Health Checks

Parse the ## Health Checks section:

## Health Checks
api: curl -s http://localhost:3000/health | grep -q "ok"
admin: curl -s http://localhost:3001 | grep -q "<!DOCTYPE"

Run each check and report results.

Step 4: Display Results

🩺 Workspace Doctor - Acme Corp

Prerequisites:
  ✓ Node.js 22.0.0 (required: 20+)
  ✓ Docker 24.0.6
  ✓ Docker Compose 2.21.0
  ✗ PostgreSQL not found (install or use Docker)

Tools:
  ✓ git 2.42.0
  ✓ curl 8.1.2
  ✓ jq 1.7

Projects:
  ✓ api - cloned at ~/work/acme/api
  ✓ admin - cloned at ~/work/acme/admin
  ✗ homepage - not cloned

Health Checks:
  ✓ api - healthy (http://localhost:3000/health)
  ○ admin - not running (port 3001)

Summary:
  • 2 issues found

Recommendations:
  • Clone missing projects: /workspaces:clone all
  • Start services: /workspaces:start all

Status Icons

  • - Passed
  • - Failed (blocking)
  • - Warning (non-blocking)

Related skills

This week in AI coding

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

unsubscribe anytime.