rest-graphql-debug

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you quickly diagnose why a REST or GraphQL integration is failing by isolating the exact layer causing wrong status codes, authentication errors, payload mismatches, or response-parsing issues.

Core Features & Use Cases

  • Step-by-step API isolation: Guides diagnosis from connectivity and timeouts through TLS/SSL, authentication, request formatting, response parsing, and semantic validation.
  • REST and GraphQL focused debugging: Provides targeted checks for REST calls and GraphQL quirks (including HTTP 200 responses that still contain errors).
  • Repro-ready verification: Recommends correlation ID capture and includes practical repro patterns to support vendor or internal debugging.

Quick Start

Ask the agent to debug a failing REST or GraphQL request end-to-end using your URL, headers (redacted if needed), request body/query, expected behavior, and the observed HTTP status and response body.

Frequently Asked Questions about rest-graphql-debug

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

FAQPage Schema
How do I debug a REST API returning unexpected HTTP status codes?

Debug unexpected REST API status codes by isolating connectivity, TLS, and authentication layers before validating request formatting and response parsing. This step-by-step API isolation identifies whether wrong status codes stem from network failures or payload mismatches.

Why does my GraphQL API return errors inside an HTTP 200 response?

GraphQL APIs often return HTTP 200 status codes while embedding application errors within the response payload. Debugging this requires handling GraphQL errors inside the HTTP 200 response payload and validating content-type before JSON parsing to isolate the semantic failure.

What is the best way to diagnose authentication failures in API integrations?

Diagnose API authentication failures by systematically isolating the TLS, request formatting, and header layers. This approach pinpoints whether auth failures originate from certificate issues, malformed credentials, or expired tokens during integration testing.

How do I verify API regressions when a provider changes behavior?

Verify API regressions by capturing correlation IDs and applying repro-ready verification patterns to compare expected behavior against observed HTTP status and response bodies. This supports vendor debugging when provider behavior changes unexpectedly.

Can I debug webhook callbacks that return unexpected response bodies?

Debug webhook callbacks returning unexpected response bodies by validating content-type before JSON parsing and inspecting HTTP headers. This isolates connectivity, authentication, and semantic validation issues for faster root-cause discovery.

What should I check when REST or GraphQL integration testing fails to parse responses?

When integration testing fails to parse responses, check the content-type validation before JSON parsing and inspect HTTP status and headers. This isolates whether parsing issues stem from request formatting errors or semantic validation failures.