route-tester

Test authenticated API routes using cookie-based JWT from Keycloak.

10.0k|1.2k|Updated Oct 30, 2025
One-click install
npx skills add https://github.com/diet103/claude-code-infrastructure-showcase --skill route-tester
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: route-tester
Source: https://github.com/diet103/claude-code-infrastructure-showcase/tree/main/.claude/skills/route-tester
Command: npx skills add https://github.com/diet103/claude-code-infrastructure-showcase --skill route-tester

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a convenient way to interact with and test backend API routes directly from Claude, eliminating the manual effort and time spent on external tools for verifying API functionality and debugging endpoints.

Core Features & Use Cases

  • Versatile HTTP Method Support: Supports all major HTTP methods (GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS) for comprehensive API interaction.
  • Customizable Requests: Allows sending requests with custom headers and various body payloads (e.g., JSON) to simulate real-world scenarios.
  • Detailed Response Analysis: Returns the full HTTP response, including status code, headers, and body, enabling quick verification and debugging.
  • Use Case: When you've just deployed a new backend API endpoint and need to quickly verify its functionality, use this Skill to send a POST request with a sample JSON payload and examine the HTTP status code and response body for immediate feedback.

Quick Start

Test the GET /api/users endpoint and report its HTTP status code and response body.

Frequently Asked Questions about route-tester

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

FAQPage Schema
How do I test authenticated API endpoints with JWT cookies?

Test authenticated routes by using cookie-based JWT authentication. The Skill obtains a refresh_token from Keycloak, signs it with your config secret, builds a refresh_token cookie, and executes authenticated GET, POST, PUT, or DELETE requests against your API endpoints to validate login flows and access control.

Can I test REST API endpoints without leaving Claude?

Yes. This Skill lets you send HTTP requests directly from Claude to test backend API routes across multiple services. You specify the endpoint, HTTP method, headers, and payload, then receive the full response including status code, headers, and body for immediate debugging.

What HTTP methods does the API testing tool support?

The Skill supports all major HTTP methods: GET, POST, PUT, DELETE, PATCH, HEAD, and OPTIONS. This enables comprehensive endpoint testing to verify different operations—retrieving data, creating records, updating resources, and removing entries—across your backend services.

How do I debug backend endpoints during development and CI testing?

Use the testing harness to execute authenticated requests against your correct base URL and route prefix. The Skill validates endpoint behavior, data handling, and access control across services like form, blog-api, workflow, and uploads, and can emit a curl command for manual reproduction.

Do I need external tools like Postman to test my API routes?

No. This Skill eliminates the need for external API testing tools by allowing you to test backend routes directly within Claude. You send requests with custom headers and JSON payloads, then analyze responses without leaving your workflow.

Can I use mock authentication when testing in development?

Yes. The Skill supports optional mock authentication in development environments, allowing you to test endpoints without live Keycloak integration while still validating your API logic and response structures.