backend-doctor

Diagnose CatGo backend issues via /api/diagnostics and apply safe fixes.

181|20|Updated Apr 29, 2026

Search Tags:#automation #troubleshooting #backend #diagnostics #hpc #catgo #safe-fixes

Ready to run

npx skills add https://github.com/Hello-QM/catgo-LRG --skill backend-doctor

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: backend-doctor
Source: https://github.com/Hello-QM/catgo-LRG/tree/main/server/catgo/workflow/skills/backend_doctor
Command: npx skills add https://github.com/Hello-QM/catgo-LRG --skill backend-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose and fix the CatGo backend when it misbehaves, helping maintain a responsive app and reducing downtime.

Core Features & Use Cases

Diagnostics-first workflow: queries /api/diagnostics to surface issues, their severity, and recommended fixes.
Safe auto-fixes: can auto-install missing optional dependencies (pymatgen, ase, asyncssh, numpy) and guide HPC reconnects when possible.
Guided remediation: clearly explains each problem and required action, with risk-aware prompts for actions beyond simple dependency installs.

Quick Start

Ask CatGo to diagnose the backend and apply safe fixes.

Frequently Asked Questions about backend-doctor

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

FAQPage Schema

How do I diagnose a CatGo backend that returns a blank UI?▼

Diagnose a CatGo backend with a blank UI by querying GET /api/diagnostics, or /api/system/diagnostics on older builds, to generate a structured report of health, dependencies, and HPC status for troubleshooting.

Can I automatically install missing backend dependencies like pymatgen and ase?▼

Yes, you can automatically install missing optional backend dependencies like pymatgen, ase, asyncssh, and numpy through safe auto-fixes that apply automatically when possible during backend troubleshooting.

What is the best way to troubleshoot HPC connectivity problems in a CatGo backend?▼

Troubleshoot HPC connectivity problems in a CatGo backend by reading the diagnostic API endpoint to check HPC status, which provides guided remediation and risk-aware prompts to help safely reconnect HPC resources.

Does the CatGo diagnostics tool apply fixes automatically?▼

Yes, the CatGo diagnostics tool applies safe fixes automatically when possible, such as installing optional dependencies, while clearly explaining required actions and using risk-aware prompts for complex remediation.

Why does the CatGo backend misbehave after missing routers are reported?▼

The CatGo backend misbehaves when missing routers occur due to dependency or configuration issues, which can be identified by running backend diagnostics to surface issue severity and actionable fix hints.

When should I manually review backend fixes instead of using safe auto-fixes?▼

Manually review backend fixes instead of using safe auto-fixes when remediation requires actions beyond simple optional dependency installs, triggering risk-aware prompts that guide you through complex configuration changes.