rest-graphql-debug

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

Updated May 14, 2026
One-click install
npx skills add https://github.com/SethyPagna/Secretary-Jarvis --skill rest-graphql-debug-sethypagna
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rest-graphql-debug
Source: https://github.com/SethyPagna/Secretary-Jarvis/tree/main/src/capabilities/optional-skills/software-development/rest-graphql-debug
Command: npx skills add https://github.com/SethyPagna/Secretary-Jarvis --skill rest-graphql-debug-sethypagna

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps diagnose REST and GraphQL failures by isolating whether the issue is connectivity, TLS, authentication, request formatting, parsing, or response semantics.

Core Features & Use Cases

It supports curl-based terminal debugging, Python requests-based reproduction, GraphQL error inspection, rate-limit handling, contract validation, and correlation ID capture for vendor support. Use it when an endpoint returns the wrong status, a token suddenly stops working, a webhook fails, an integration behaves differently across tools, or an API upgrade breaks an existing client. It is designed to produce a minimal reproducible case, explain the likely root cause, and suggest the most reliable fix.

Quick Start

Ask the assistant to debug the failing REST or GraphQL endpoint, reproduce the request, identify the broken layer, and return a concise repro and fix.

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 endpoint that returns unexpected status codes?

Debug REST API failures by reproducing the request, inspecting the response, and isolating whether the issue stems from connectivity, TLS, authentication, or request formatting. This process produces a minimal reproducible case and suggests a reliable fix for the broken layer.

Why does my authentication token suddenly stop working on a vendor API?

Authentication token failures on vendor APIs are diagnosed by isolating the broken layer and inspecting HTTP responses. The debugging process identifies whether the issue originates from TLS, token expiration, request formatting, or rate limiting, and returns a concise fix.

What's the best way to troubleshoot GraphQL API errors and invalid schema responses?

Troubleshoot GraphQL API errors by inspecting responses and validating schemas to isolate parsing or semantic errors. This approach identifies the root cause of query failures and returns a minimal reproducible case alongside the most reliable fix.

How do I track down a failing webhook integration across different tools?

Track failing webhook integrations by reproducing the HTTP request and inspecting the response to pinpoint the broken layer. Correlation ID capture and response inspection identify whether the failure originates from connectivity, parsing, or semantic errors.

Can I use curl and Python requests to isolate rate limiting and pagination issues?

Yes, curl and Python requests are used to reproduce endpoint failures and isolate rate limiting or pagination issues. By inspecting HTTP responses and validating request formatting, the debugging process identifies the root cause and returns a targeted fix.

When should I use correlation ID tracking for API troubleshooting?

Use correlation ID tracking for API troubleshooting when diagnosing vendor API failures or complex integration test issues. Capturing correlation IDs isolates the root cause across distributed requests and provides support teams with a minimal reproducible case.