Skills
.Work. You
Rest

workspace-doctor

Official

Diagnose and fix BotMinter workspace issues

Software Engineering#git#troubleshooting#workspace#diagnostics#symlinks#submodule#botminter
Authorbotminter
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Detects common BotMinter workspace configuration and synchronization problems that prevent agents from running correctly or cause inconsistent behavior, and surfaces actionable fixes so operators can restore healthy workspaces quickly.

Core Features & Use Cases

  • Workspace provisioning checks: Verifies presence of the workspace marker and required files such as ralph.yml, CLAUDE.md, and PROMPT.md.
  • Repository and sync diagnostics: Identifies missing or stale team submodules, detached HEAD states, and uncommitted changes.
  • Runtime and link validation: Finds broken .claude/agents symlinks and stale Ralph lock files and reports appropriate remediation steps.
  • Use case: When an operator reports "my agent can't start" or "workspace sync failed", run this Skill to get a concise health table with OK/WARN/FAIL statuses and recommended CLI commands to fix the issues.

Quick Start

Run a workspace health check for a member or entire team to list marker, submodule, file, symlink, lock, and git issues and receive suggested CLI fixes.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: workspace-doctor
Download link: https://github.com/botminter/botminter/archive/main.zip#workspace-doctor

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.