space-doctor

Diagnose Anteroom space configuration and repository health with validation and git checks.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/troylar/anteroom --skill space-doctor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: space-doctor
Source: https://github.com/troylar/anteroom/tree/main/src/anteroom/cli/default_skills/space-doctor
Command: npx skills add https://github.com/troylar/anteroom --skill space-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detects and explains configuration, repository, and pack problems that prevent an Anteroom space from working as expected, providing clear guidance and safe, user-approved remediation steps so teams can restore space health without guesswork.

Core Features & Use Cases

  • Space validation: Parse and validate the space YAML, surface schema errors, and report instruction/config counts.
  • Repository & git health checks: Verify repo paths, git worktree status, remotes, branches, and uncommitted changes.
  • Pack and hot-reload checks: Confirm pack installation status and whether the space file hash is fresh or needs refresh; explain hot-reload implications.
  • Use Case: Onboarding a developer who finds a space with missing repos and stale hashes, the skill lists issues, explains impact, and offers to run clones, installs, or refreshes after explicit approval.

Quick Start

Diagnose the space named my-space, list all issues with explanations, and offer safe, user-approved fixes.

Frequently Asked Questions about space-doctor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose and fix Anteroom space configuration errors?

To diagnose Anteroom space configuration errors, the skill validates the space YAML, checks repo paths, and verifies pack installation status. It provides clear explanations for schema issues and offers safe, user-approved remediation steps to restore space health.

Why does my Anteroom space have stale file hashes and how do I refresh them?

Stale file hashes occur when the space YAML changes without triggering a hot-reload. The skill checks file hash freshness, explains hot-reload implications, and offers to run refreshes after explicit user approval to ensure the workspace is current.

How do I check git repository health and uncommitted changes for an Anteroom space?

To check git repository health, the skill verifies git worktree status, remotes, branches, and detects uncommitted changes. It reports these repository issues alongside space configuration problems to provide a comprehensive health overview.

Do I need the Anteroom CLI and git installed to diagnose space issues?

Yes, you need the Anteroom CLI environment, file paths, and permissions to run git and Python validation commands. The skill requires this access to perform diagnostics and execute optional remediation steps with explicit user consent.

Can I automatically clone missing repositories and install packs for an Anteroom space?

Yes, when missing repositories or uninstalled packs are detected, the skill lists the issues, explains their impact, and offers to run clones and installs automatically. These remediation actions only execute after receiving explicit user approval.