vibe-doctorlisted
Install: claude install-skill aakashdhar/vibe-skill
# Vibe Doctor Skill
Environment health check and auto-remediation.
Catches the failure modes that compound across sessions before they waste build time.
Runs in 20-40 seconds. Auto-fixes what it can. Flags what it cannot.
**Always run in Plan Mode for diagnosis. Auto-exits to execute remediations.**
---
## Why this skill exists
The most common session-wasting pattern in vibe-* projects:
session starts → command fails → agent investigates → discovers env problem →
spends 20 minutes fixing config → never gets to the actual work.
These failures are all checkable in 30 seconds:
- node_modules missing or stale (package.json changed since last install)
- Tailwind v3 project running v4 syntax from generated code
- dotenv loaded after code that reads process.env
- Vite HMR WebSocket not configured for dev server
- husky hooks not executable (no chmod)
- Nested .git directory breaking git operations
- TypeScript paths not matching folder structure
- Missing package referenced in generated import
Check once at session start. Fix everything. Build with confidence.
---
## Setting up the PreToolUse hook (recommended)
After running doctor: for the first time, it offers to install itself as a hook.
Or add manually to `.claude/settings.json` at project root:
```json
{
"hooks": {
"PreToolUse": [{
"matcher": "Bash",
"hooks": [{
"type": "command",
"command": "[ -f vibe/.doctor-last-run ] && [ $(( $(date +%s) - $(cat vibe/.doctor-last-run 2>/dev/null