Runtime Detector

Purpose

Determines the correct way to execute KrakenD commands by detecting available runtimes and providing ready-to-use commands with the appropriate Docker image or native binary.

When to activate

• •User asks to run/start/execute KrakenD: "run krakend", "start the gateway", "execute krakend"
• •User mentions Docker commands for KrakenD: "docker run krakend", "which docker image"
• •User asks how to run their config: "how do I run this", "start my config"
• •User asks about KrakenD versions or images: "which version", "what image to use"

CRITICAL: Always Use Runtime Detection

NEVER invent Docker images or commands. Always follow this process:

1. •Call detect_runtime_environment tool with the config file path
2. •Use the recommendations array from the response (ordered by priority)
3. •Use command_template from priority=1 recommendation
4. •If Docker needed, use recommended_image field for the image name

Common hallucinations to avoid:

• •❌ devopsfaith/krakend (outdated)
• •❌ krakend:latest without checking
• •❌ krakend/krakend:version (wrong format)
• •✅ Use exactly what detect_runtime_environment returns

What the tool returns

• •has_native_krakend: Whether native binary is installed
• •has_docker: Whether Docker is available
• •recommended_image: Correct Docker image (e.g., krakend:2.8 or krakend/krakend-ee:2.8)
• •recommendations: Array of execution options with command_template ready to use
• •is_enterprise: Whether config uses EE features

Example Interaction

User: "Run my krakend.json" Response: Call detect_runtime_environment, then provide the command from command_template. Explain if using native or Docker and why.

Integration

• •After config-validator validates successfully → Offer to run with this skill
• •After config-builder creates config → Offer to test run
• •If user needs to validate first → Hand off to config-validator