troubleshooting-assistant

Diagnose and resolve MCP, GPU, BigQuery, index, and import failures.

167|28|Updated Nov 15, 2025
One-click install
npx skills add https://github.com/RobThePCGuy/Claude-Patent-Creator --skill troubleshooting-assistant
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: troubleshooting-assistant
Source: https://github.com/RobThePCGuy/Claude-Patent-Creator/tree/main/skills/troubleshooting-assistant
Command: npx skills add https://github.com/RobThePCGuy/Claude-Patent-Creator --skill troubleshooting-assistant

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

When a complex AI system encounters errors, diagnosing the root cause can be time-consuming and frustrating. This Skill provides an expert diagnostic methodology and tools to quickly identify and resolve issues, minimizing downtime and frustration.

Core Features & Use Cases

  • 6-Step Diagnostic Workflow: Guides you through gathering information, reproducing, isolating, diagnosing, fixing, and preventing recurrence of issues.
  • Quick Fixes for Common Problems: Provides immediate solutions for MCP server loading, GPU detection, BigQuery authentication, and index build failures.
  • Component Isolation Tools: Helps pinpoint the exact failing part of the system for targeted debugging.
  • Use Case: The MPEP search is returning errors, and the user doesn't know why. This skill guides them through checking the index status, BigQuery configuration, and relevant logs to pinpoint and fix the problem efficiently.

Quick Start

My MPEP search is failing. Help me diagnose the issue using the troubleshooting assistant.

Frequently Asked Questions about troubleshooting-assistant

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

FAQPage Schema
How do I diagnose why my MCP server registration is failing?

MCP server registration failures often stem from configuration mismatches or connectivity issues. This Skill guides you through gathering logs, reproducing the error, isolating which component fails, and applying targeted fixes. Use the structured 6-step diagnostic workflow to check server status, validate configuration, and verify network connectivity.

Why is GPU detection not working in my AI system deployment?

GPU detection issues typically arise from driver problems, misconfigured environment variables, or hardware visibility problems. This Skill provides health checks and command templates to verify GPU availability, validate driver installation, and troubleshoot visibility across your system. The diagnostic methodology isolates whether the issue is hardware, driver, or configuration-level.

How do I fix BigQuery authentication errors in my AI system?

BigQuery authentication problems often involve credential misconfigurations, permission gaps, or service account setup issues. This Skill includes validation steps to verify credentials, check IAM permissions, and test connectivity. The troubleshooting process helps you identify whether the issue is credential format, scope, or access control.

What should I do when index builds fail or search quality degrades?

Index build failures and search quality issues can stem from data pipeline problems, configuration errors, or resource constraints. This Skill provides component isolation tools to pinpoint failures in indexing, data import, or query logic, with built-in health checks and documented remediation steps to restore search performance.

How do I systematically troubleshoot performance problems in complex AI deployments?

Performance degradation requires structured diagnosis across servers, GPUs, authentication services, and data pipelines. This Skill applies a 6-step diagnostic methodology—gather information, reproduce, isolate, diagnose root cause, apply fix, prevent recurrence—with health checks and command templates for each component to minimize downtime.

Can I use this troubleshooting approach for systems outside Claude Patent Creator?

This Skill is specifically designed for Claude Patent Creator deployments with MCP server, GPU, BigQuery, and index components. While the 6-step diagnostic methodology is generalizable, the quick fixes, health checks, and command templates target this specific system architecture and may not directly apply to other platforms.