# Redsub Doctor

> Diagnose and auto-repair plugin integrity. Use when this capability is needed.

- Skill: `tomevault-io/redsub-doctor` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/redsub-doctor`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/redsub-doctor/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/redsub-doctor

---


# Doctor

Diagnose plugin health and auto-repair issues.

## Checks

### 1. Legacy rules cleanup

Check for orphaned rules files from previous versions in `~/.claude/rules/`:
```bash
ls ~/.claude/rules/redsub-*.md 2>/dev/null
```

If any `redsub-*.md` files are found, they are leftovers from v2.x (v3.0 no longer deploys rules files).

**Auto-fix**: Remove orphaned files:
```bash
rm -f ~/.claude/rules/redsub-*.md
```

### 2. Manifest consistency

Read `~/.claude-redsub/install-manifest.json`:
- Verify all `files_created` are tracked
- Verify version matches plugin version

**Auto-fix**: Regenerate manifest from current state.

### 3. Dependency plugins

**Read the plugin registry from `${CLAUDE_PLUGIN_ROOT}/config/plugins.json`** — this is the Single Source of Truth (SSOT). Do NOT use a hardcoded list.

For each plugin in the registry, check `~/.claude/plugins/installed_plugins.json`:
- A plugin is **missing** if its key (`<name>@<marketplace>`) does not exist
- A plugin is **not installed** if its key exists but `gitCommitSha` is empty — `register-plugins.sh` creates placeholder entries that Claude Code auto-resolves (`installPath`/`version` get filled from marketplace cache), but without `gitCommitSha` they are NOT recognized as installed in `/plugin` Installed tab

Both cases should be reported and offered for auto-install.

**Report**: List missing/uninstalled plugins with install commands constructed from `name` and `marketplace` fields:
```
Missing: <name> (not registered)
Install: /plugin install <name>@<marketplace>
```
or:
```
Missing: <name> (registered but not installed — empty gitCommitSha)
Install: /plugin install <name>@<marketplace>
```

**Auto-fix**: Use `AskUserQuestion` to ask user whether to auto-install missing plugins. If yes, run each sequentially:
```bash
claude plugin install <name>@<marketplace>
```

### 4. CLAUDE.md marker integrity

If CLAUDE.md contains `<!-- redsub-claude-code:start -->`:
- Verify matching `<!-- redsub-claude-code:end -->` exists
- Verify content between markers is valid
- Check `<!-- redsub-template-version:X.X.X -->` inside markers:
  - Compare with version in `${CLAUDE_PLUGIN_ROOT}/templates/CLAUDE.md.template`
  - Report: "Template: current (vX.X.X)" / "Template: outdated (vX.X.X → vY.Y.Y)" / "Template: legacy (no version)"

**Auto-fix**: Re-inject markers if corrupted. For outdated templates, suggest `/redsub-update`.

### 5. Hooks integrity

Verify `${CLAUDE_PLUGIN_ROOT}/hooks/hooks.json` is valid JSON.
Verify all referenced scripts exist and are executable.

**Auto-fix**: Re-set executable permissions on scripts.

### 6. Prefix consistency

Search all plugin files for legacy `/rs-` references:
```bash
grep -r '/rs-' ${CLAUDE_PLUGIN_ROOT}/skills/ ${CLAUDE_PLUGIN_ROOT}/agents/ 2>/dev/null
```

**Report**: List any legacy references found.

## Output

```
Plugin health check:
- Legacy rules: [CLEAN/REMOVED N files]
- Manifest: [OK/FIXED/MISSING]
- Dependencies: [OK/N missing] (12 plugins)
- CLAUDE.md markers: [OK/FIXED/N/A]
- Template version: [current/outdated/legacy]
- Hooks: [OK/FIXED]
- Prefix consistency: [OK/N legacy refs]

Overall: [HEALTHY/REPAIRED/NEEDS ATTENTION]
```

If issues were auto-fixed, summarize what changed.
If issues need manual intervention, provide specific instructions.

---
> Source: [redsub-captain/redsub-claude-code](https://github.com/redsub-captain/redsub-claude-code) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-04 -->