vibe-check-doctor

Diagnose vibe-check configuration and operational issues with status checks and fixes.

1|1|Updated Dec 29, 2025
One-click install
npx skills add https://github.com/wanderingstan/vibe-check --skill vibe-check-doctor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vibe-check-doctor
Source: https://github.com/wanderingstan/vibe-check/tree/main/skills/vibe-check-doctor
Command: npx skills add https://github.com/wanderingstan/vibe-check --skill vibe-check-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Troubleshoot and diagnose vibe-check setup to help users quickly identify configuration and operational issues, improving reliability and uptime.

Core Features & Use Cases

  • Get current service status and critical details to determine health and readiness.
  • Read and verify the configuration file to confirm correct directories and options (e.g., conversation directory, local storage, and remote sync).
  • Identify and resolve common problems such as the service not running, database creation issues, missing MCP or skills, and remote sync failures.
  • Follow structured guidance and commands to diagnose and remediate issues, with links to further documentation when needed.

Quick Start

Run vibe-check status and follow the guided troubleshooting steps to fix issues.

Frequently Asked Questions about vibe-check-doctor

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

FAQPage Schema
Why is vibe-check not recording conversations or running properly?

Vibe-check fails to run or record conversations due to configuration errors, missing MCP components, or database creation issues. Run a status check and verify the configuration file to diagnose the exact operational failure.

How do I troubleshoot vibe-check configuration and remote sync failures?

Troubleshoot vibe-check configuration by verifying the conversation directory, local storage paths, and remote sync options in the config file. Follow structured diagnostic steps to parse service status and apply actionable remediation commands.

What is the best way to check vibe-check service status and health?

The best way to check vibe-check service health is to run the status command. This retrieves current service status and critical details, guiding you through configuration verification and common fixes for missing skills or sync failures.

Does vibe-check require specific MCP or skills setup to diagnose issues correctly?

Vibe-check troubleshooting requires MCP and skills to be properly configured. Missing MCP components or skills cause service disruptions; diagnostic steps verify these dependencies and provide remediation guidance to restore full operational readiness.

How do I fix vibe-check database creation issues and misreporting status?

Fix vibe-check database creation issues and status misreporting by running guided status checks. The diagnostic process parses service status, verifies configuration directories, and applies structured troubleshooting steps to resolve common operational errors.