troubleshoot

Diagnose Facets infrastructure problems and prescribe fixes using Raptor CLI commands.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Facets-cloud/facets-getting-started --skill troubleshoot-facets-cloud
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: troubleshoot
Source: https://github.com/Facets-cloud/facets-getting-started/tree/main/ai-setup/gemini/skills/troubleshoot
Command: npx skills add https://github.com/Facets-cloud/facets-getting-started --skill troubleshoot-facets-cloud

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnoses and fixes Facets infrastructure problems based on symptoms, enabling faster restoration of services.

Core Features & Use Cases

  • Hypothesis-driven troubleshooting: automatically form likely causes and guide root-cause analysis.
  • Evidence gathering: queries resource-status, releases, and logs to validate hypotheses.
  • Guided fixes: prescribes exact commands and steps to implement recovery actions and verify results.

Quick Start

Describe the symptoms concisely and instruct the agent to diagnose, gather evidence, and prescribe a fix.

Frequently Asked Questions about troubleshoot

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

FAQPage Schema
How do I troubleshoot Facets infrastructure deployment failures and slowdowns?

To troubleshoot Facets infrastructure issues, describe the symptoms concisely. The system applies a structured thinking chain using Raptor CLI to query releases, resource status, and logs, forming hypotheses to provide root causes and verification steps.

What is the best way to find the root cause of a broken Facets resource across environments?

Finding the root cause of broken Facets resources involves hypothesis-driven troubleshooting. The system automatically forms likely causes and queries resource status and logs to validate hypotheses, enabling faster restoration of services across environments.

How does Raptor CLI query resource status and logs for incident management?

Raptor CLI queries resource status, releases, and logs for incident management by gathering evidence to validate hypotheses. It applies a structured thinking chain to diagnose Facets infrastructure problems from symptoms and prescribe exact recovery actions.

Can I use this approach to fix connectivity issues in my deployment?

Yes, you can use this approach to fix connectivity issues in your deployment. The system diagnoses and fixes Facets infrastructure problems from symptoms, applying guided fixes that prescribe exact commands and steps to implement recovery actions and verify results.

What should I do if my Facets infrastructure troubleshooting is not working?

If Facets infrastructure troubleshooting is not working, ensure you describe the symptoms concisely and instruct the agent to diagnose, gather evidence, and prescribe a fix. The system relies on accurate symptoms to query logs and form correct root-cause hypotheses.