repo-b-thin-waist-routing - SKILL.md Agent Skill

name: repo-b-thin-waist-routing description: Validate and troubleshoot thin-waist REST routing in . Use when changing /v1 models/chat/vision routes, async job queue endpoints, connector routing policy, or bind/exposure behavior.

REPO_B Shim Thin-Waist Routing

Use this skill for REST route verification and routing policy integrity.

Workflow

Confirm loopback bind and LAN guard defaults.
Validate OpenAI-compatible façade routes.
Validate native async job endpoints and queue state.
Confirm routing policy remains centralized in ModelRouter.

Scope Boundary

Use this skill for /v1/* façade and /api/jobs thin-waist routing behavior.

Do not use this skill for:

MCP adapter and shim.comfy.* contract diagnostics lanes.
Agent Bridge capability/task safety checks.
Windows-host vs WSL connectivity troubleshooting.

Quick Verification

curl http://127.0.0.1:9000/v1/models
curl -X POST http://127.0.0.1:9000/v1/chat/completions -H "content-type: application/json" -d '{"model":"llama-3.2-1b-instruct","messages":[{"role":"user","content":"ping"}]}'
curl -X POST http://127.0.0.1:9000/v1/vision -H "content-type: application/json" -d '{"model":"radeon-qwen3-vl-2b","prompt":"describe","image_data_url":"data:image/png;base64,<BASE64_PAYLOAD>"}'

curl -X POST http://127.0.0.1:9000/api/jobs -H "content-type: application/json" -d '{"type":"chat","prompt":"ping"}'
curl http://127.0.0.1:9000/api/resources

Key Env Vars

SHIM_BIND_HOST, SHIM_BIND_PORT, SHIM_ALLOW_LAN
SHIM_MAX_CONCURRENCY, SHIM_JOB_QUEUE_MAX, SHIM_JOB_TIMEOUT_S
SHIM_VISION_MAX_IMAGE_BYTES

Reference

references/thin-waist-checklist.md

Loopback

If this lane is unresolved, blocked, or ambiguous:

Capture current evidence and failure context.
Route back through $skill-hub for chain recalculation.
Resume only after the updated chain returns a deterministic next step.