rest-graphql-debug

Diagnose failing REST and GraphQL API calls by isolating connectivity, TLS, authentication, and parsing layers.

1|Updated May 16, 2026
One-click install
npx skills add https://github.com/devMoez/titan --skill rest-graphql-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rest-graphql-debug
Source: https://github.com/devMoez/titan/tree/main/optional-skills/software-development/rest-graphql-debug
Command: npx skills add https://github.com/devMoez/titan --skill rest-graphql-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Rest and GraphQL integrations often fail in confusing ways where HTTP status codes, authentication, and response shapes do not clearly explain the root cause, wasting time on guesswork.

Core Features & Use Cases

  • Layered API diagnosis: Walks through connectivity, TLS, authentication, request formatting, response parsing, and semantic validation to isolate the failing layer.
  • REST + GraphQL coverage: Handles REST endpoints and GraphQL quirks such as HTTP 200 responses that still contain an errors field.
  • Reproducible debugging and regression: Provides a practical workflow to produce targeted repros and draft smoke tests for common failure modes.
  • Security-conscious handling: Encourages token redaction and safe logging practices while debugging.

Quick Start

Use the rest-graphql-debug skill to debug a failing endpoint by requesting a step-by-step layer isolation plan and the exact curl and response checks you should run for your specific status code, auth method, and payload.

Frequently Asked Questions about rest-graphql-debug

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

FAQPage Schema
Why does my GraphQL API return a 200 OK status but still fail?

GraphQL APIs often return HTTP 200 even when errors occur by placing them in an `errors` field. You must inspect the response body semantics to verify GraphQL `errors` regardless of the HTTP 200 status.

How do I debug a REST API authentication failure returning 401 or 403?

Debug REST API auth failures by isolating the TLS, authentication, and request formatting layers. Use deterministic curl commands to verify HTTP headers and token payloads to identify the failing authentication layer.

What is the best way to isolate a failing REST or GraphQL integration?

The best way to isolate a failing REST or GraphQL integration is through layered API diagnosis. Walk through connectivity, TLS, authentication, request formatting, and response parsing to pinpoint the exact failing layer.

How do I create a reliable reproduction for an intermittent API failure?

Create a reliable reproduction for API failures by using deterministic terminal and Python requests patterns. Include timeouts and correlation IDs in your HTTP headers to ensure consistent and traceable triage.

How do I safely debug API calls without exposing sensitive authentication tokens?

Safely debug API calls by applying security-conscious handling during your triage. Use token redaction and safe logging practices while inspecting HTTP headers to prevent exposing sensitive authentication data.

How do I diagnose schema contract drift after an API migration?

Diagnose schema contract drift after migrations by verifying response parsing and semantic meaning across real reproductions. Inspect REST-vs-GraphQL discrepancies and HTTP body semantics to detect unexpected response shape changes.