add-internal-route

What problem does it solve?

This Skill assists in adding new routes under the /internal/* path in the remote-server application, handling the split authentication model and ensuring the correct handling of active-run guards for routes that execute agent turns.

Core Features & Use Cases

• Adding Routes: Provides step-by-step instructions to register handlers and set up authentication for new internal routes.
• Authentication Model: Explains the split authentication process where middleware enforces loopback checks and per-handler checks for INTERNAL_API_SECRET.
• Active-Run Guard Handling: Guides on the proper placement of routes that execute agent turns relative to the active-run guard.

Quick Start

Run the add-internal-route skill to set up a new internal route under /internal/my-route with proper authentication and guard checks.