troubleshoot

Diagnose MCP server and index issues with stepwise validation.

13|3|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/jamie8johnson/cqs --skill troubleshoot-jamie8johnson
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: troubleshoot
Source: https://github.com/jamie8johnson/cqs/tree/main/.claude/skills/troubleshoot
Command: npx skills add https://github.com/jamie8johnson/cqs --skill troubleshoot-jamie8johnson

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Guided diagnosis of common cqs issues. Run through checks in order, stop at first problem found.

Core Features & Use Cases

  • Stepwise verification of installation, initialization, indexing, and connectivity.
  • Comprehensive checks for stale indices, schema mismatches, and broken references.
  • Real-world remediation guidance for local development, CI, and staging environments.

Quick Start

Follow the checklist in order, starting with verifying the cqs version and then ensuring the MCP server connects.

Frequently Asked Questions about troubleshoot

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

FAQPage Schema
How do I troubleshoot a stale index in my MCP server?

To troubleshoot a stale index in your MCP server, run a stepwise verification of the indexing process. This guided diagnosis checks schema versions and enforces index validation to identify broken references and resolve the stale state.

Why does my MCP server connectivity fail during local development?

MCP server connectivity fails during local development due to initialization errors or model download issues. Diagnose the failure by verifying installation steps and checking model availability to restore your connection.

What is the best way to resolve cqs schema mismatches in CI?

The best way to resolve cqs schema mismatches in CI is to run a guided diagnostic check. This validates schema versions against your index to detect broken references and provides remediation steps for your staging environment.

Does this troubleshooting process work for staging environments?

Yes, this troubleshooting process works for staging environments. It provides real-world remediation guidance and stepwise connectivity checks specifically designed for local development, CI, and staging setups.

How do I diagnose cqs model download issues?

To diagnose cqs model download issues, follow the stepwise validation checklist. It verifies model availability as part of the initialization process and provides clear remediation steps if downloads are blocked.