skills.rest
trevorbyrum
trevorbyrumCOMMUNITY
Explore all skills by this author →
GitHub

skill-doctor

Diagnose Claude skill suite integrity, CLI reachability, and configuration correctness.

1|1|Updated Mar 9, 2026
Search Tags:#troubleshooting#configuration#health check#CLI tools#diagnostic#skill suite
One-click install
npx skills add https://github.com/trevorbyrum/claude-skills-suite --skill skill-doctor-trevorbyrum
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-doctor
Source: https://github.com/trevorbyrum/claude-skills-suite/tree/main/skills/skill-doctor
Command: npx skills add https://github.com/trevorbyrum/claude-skills-suite --skill skill-doctor-trevorbyrum

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, gh, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a comprehensive self-diagnostic for the entire skill suite, identifying missing files, unreachable CLIs, and configuration errors to ensure smooth operation.

Core Features & Use Cases

  • System Health Check: Verifies the integrity of all skill units, templates, and reference files.
  • Dependency Verification: Checks for the presence and accessibility of required external command-line tools.
  • Configuration Validation: Ensures critical flags like disable-model-invocation are correctly set.
  • Use Case: After installing a new skill or encountering an unexpected error, run the Skill Doctor to pinpoint the exact cause and receive instructions for resolution.

Quick Start

Run the skill doctor to perform a full diagnostic of the skill suite.

Frequently Asked Questions about skill-doctor

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

FAQPage Schema
How do I run a health check on my skill suite to find missing files?▼

Run a skill suite health check to verify file integrity across all skill units, templates, and references. The diagnostic scans for missing components and reports failures with specific fix instructions to restore your configuration.

Why does my skill configuration fail when using external CLI tools?▼

Your skill configuration may fail if external CLI dependencies like jq or gh are unreachable. A diagnostic checks for the presence and accessibility of required command-line tools and reports missing dependencies with resolution steps.

What does a skill suite diagnostic verify during troubleshooting?▼

A skill suite diagnostic verifies file integrity, external CLI reachability, and configuration correctness. It identifies missing components, validates critical flags like disable-model-invocation, and generates a summary report for troubleshooting.

Do I need jq and gh installed to validate my skill configuration?▼

Yes, you need jq and gh installed to validate your skill configuration. The diagnostic performs dependency verification by checking for the presence and accessibility of these required external command-line tools.

When should I perform a self-diagnostic on my skill suite?▼

Perform a self-diagnostic on your skill suite after installing a new skill or encountering an unexpected error. The diagnostic pinpoints the exact cause of configuration errors, missing files, or unreachable CLIs and provides resolution instructions.

What is the best way to fix configuration errors in a skill suite?▼

The best way to fix skill suite configuration errors is running a comprehensive diagnostic that validates critical flags like disable-model-invocation. It identifies exact failures and outputs fix instructions in a summary report.

Related Skills

Explore More Software Engineering Skills→
atournayreatournayre

orchestrator:check-prerequisites

Verify gh CLI, jq, and git availability before automated workflows.

Community
Basic
AcosmiAcosmi
6

doctor-diagnostics

Diagnoses and repairs system health across authentication, configuration, gateway, sandbox, and workspace modules via a 17-module suite.

Community
Advanced
chrono-metachrono-meta
7

cross-ecosystem-synergy-detection

Detect compatible synergy pairs among installed plugins and cross-CLI tools.

Community
Advanced
tursodatabasetursodatabase
23.8k

debugging

Compare bytecode, logs, and sanitizer outputs to debug Turso databases.

Official
Advanced