skills.rest
ojowwalker77
ojowwalker77COMMUNITY
Explore all skills by this author →
GitHub

Matrix Doctor

Diagnose and repair Matrix plugin health issues, returning a structured DoctorResult object.

110|9|Updated Dec 16, 2025
Search Tags:#database#claude#configuration#plugin#diagnostics#autofix#matrix
One-click install
npx skills add https://github.com/ojowwalker77/Claude-Matrix --skill matrix-doctor
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Matrix Doctor
Source: https://github.com/ojowwalker77/Claude-Matrix/tree/main/skills/doctor
Command: npx skills add https://github.com/ojowwalker77/Claude-Matrix --skill matrix-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Matrix Doctor identifies and resolves failures in the Claude Matrix plugin by running end-to-end health checks and applying safe automatic repairs so the plugin returns to a usable state.

Core Features & Use Cases

  • Directory and Permissions Check: Verifies the Matrix directory exists at ~/.claude/matrix and is writable, creating it when missing.
  • Database and Schema Validation: Tests database connectivity, validates schema version, and reinitializes the database if required.
  • Configuration and Hooks Validation: Detects invalid or missing configuration sections and broken hooks, resetting to defaults or reinstalling hooks.
  • Code Index and Repo Detection: Confirms repository indexing and fingerprinting, triggers reindexing when necessary.
  • Use Case: When Matrix fails to index a repository or reports database errors, run Matrix Doctor to automatically diagnose the root cause, fix common problems, and generate a GitHub issue template if manual intervention is required.

Quick Start

Run the Matrix Doctor to diagnose and automatically repair the Matrix plugin on the current machine with automatic fixes enabled.

Frequently Asked Questions about Matrix Doctor

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

FAQPage Schema
How do I fix Matrix plugin database errors and repository indexing failures?▼

Fix Matrix plugin database errors and indexing failures by running an automated diagnostic process that tests database connectivity, validates schema versions, and triggers repository reindexing to restore normal plugin operation.

What does a Matrix plugin health check cover?▼

A Matrix plugin health check covers directory permissions at ~/.claude/matrix, database connectivity, configuration validity, hook installation status, code indexing integrity, and repository fingerprinting to detect operational anomalies.

Can I automatically repair broken Matrix plugin configurations and hooks?▼

Yes, you can automatically repair broken Matrix plugin configurations and hooks by triggering the diagnostic autofix process, which detects invalid configuration sections, resets them to defaults, and reinstalls missing hooks.

Why does the Matrix plugin fail to create directories or connect to the database?▼

The Matrix plugin fails to create directories or connect to the database when local installation permissions are invalid or the schema is corrupted, requiring diagnostic reinitialization of the database and creation of missing directories.

How do I generate a GitHub issue template for persistent Matrix plugin problems?▼

Generate a GitHub issue template for persistent Matrix plugin problems by running the diagnostic tool, which returns a structured result object containing environment details, failure suggestions, and a pre-filled issue template for manual intervention.

Related Skills

Explore More Software Engineering Skills→
richardmbaileyrichardmbailey

rb-setup-local-agent-skills

Audit local RB agent skill installations and symlink targets across Codex and Claude Code.

Community
Intermediate
Codagent-AICodagent-AI
30

fix-pr

Resolve CI failures and review comments on GitHub pull requests.

Official
Advanced
MinhThang1009MinhThang1009
15

hook-development

Design, implement, and validate Claude Code plugin hooks for event-driven automation.

Community
Advanced
OpenAEC-FoundationOpenAEC-Foundation
4

tauri-errors-permissions

Diagnose Tauri 2 permission errors and CSP violations with a decision tree.

Official
Advanced