install-doctor

What problem does it solve?

Installing meta-harness plugins into existing projects often leads to unexpected conflicts with pre-existing CLAUDE.md rules, custom skills, hook events, or audit practices that can break workflows or cause silent file overwrites. This skill eliminates guesswork by scanning your environment before and after installation to flag all potential issues before they cause problems.

Core Features & Use Cases

• Pre and post-install environment scanning: Detects conflicts across 5 key areas: CLAUDE.md rule definitions, skill trigger vocabulary, hook event assignments, .claudeignore scope rules, and existing audit/log file formats.
• MCP transport security checks: Flags unauthenticated HTTP/SSE MCP server configurations that expose local network ports to remote access risks.
• Actionable diagnosis reports: Separates immediate action required items from recommended post-install checks, so you know exactly what to fix before proceeding with installation.
• Use Case: If you want to add the fh-meta plugin to a project that already has custom PR review rules and existing Claude Code skills, run this skill first to confirm there are no overlapping triggers or conflicting audit practices that would disrupt your team's workflow.

Quick Start

Ask the AI to run the install-doctor skill to scan your current project environment for potential conflicts with the fh-meta meta-harness plugin before you proceed with installation.