route-tester

Automate authenticated route testing with cookie-based JWT and Keycloak tokens.

Updated Feb 13, 2026
One-click install
npx skills add https://github.com/mwathiben/PropManager --skill route-tester-mwathiben
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: route-tester
Source: https://github.com/mwathiben/PropManager/tree/main/.claude/skills/route-tester
Command: npx skills add https://github.com/mwathiben/PropManager --skill route-tester-mwathiben

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validate and test authenticated routes in your project by automating cookie-based JWT authentication and Keycloak integration, reducing manual debugging time.

Core Features & Use Cases

  • Automatically obtain refresh tokens from Keycloak and build cookie headers for authenticated requests.
  • Provide multiple testing methods: scripted tests with test-auth-route.js, manual curl reproduction, and development-only mock authentication.
  • Guide you through common scenarios like GET, POST, workflow starts, and protected endpoints across services.

Quick Start

Run the test-auth-route.js script against a target URL to generate an authenticated request and reproduce it with curl.

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 routes with cookie-based JWT tokens?

You can test authenticated API routes using an automated script that handles cookie-based JWT authentication, retrieves tokens from Keycloak, constructs cookie headers, and generates reproducible curl requests for validation.

How do I automate Keycloak token retrieval for route testing?

Automating Keycloak token retrieval is handled by the test-auth-route.js script, which obtains refresh tokens, signs JWTs, and constructs cookie headers to build authenticated HTTP requests against your target URL.

Can I reproduce authenticated curl requests manually for protected endpoints?

Yes, you can reproduce authenticated curl requests manually by running the test-auth-route.js script against a target URL, which generates the exact authenticated request with constructed cookie headers for manual curl reproduction.

Does this route testing approach support mock authentication for development?

Yes, mock authentication is supported as a development-only testing method, providing an alternative to Keycloak integration for validating protected endpoints and route prefixes without requiring a live authentication server.

What's the best way to validate route protection across multiple services?

The best way to validate route protection across services is using automated auth tests that handle token retrieval, JWT signing, and cookie construction, supporting GET, POST, and workflow start scenarios with environment configurations.

Why do my authenticated route tests fail with missing cookie headers?

Authenticated route tests fail with missing cookie headers when token retrieval or JWT signing is incomplete; using an automated test script ensures proper cookie construction and reproducible HTTP requests for protected endpoints.