add-runtime

Add a new runtime backend to the kdn runtime system.

10|14|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/openkaiden/kdn --skill add-runtime-openkaiden
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-runtime
Source: https://github.com/openkaiden/kdn/tree/main/.agents/skills/add-runtime
Command: npx skills add https://github.com/openkaiden/kdn --skill add-runtime-openkaiden

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides developers through adding a new runtime implementation to the kdn runtime system, enabling support for additional backends.

Core Features & Use Cases

  • Runtime extension: add support for new backends like Podman, MicroVM, Kubernetes, or a fake runtime for testing.
  • Structured integration: implement the runtime interface and wire it into the registry so it appears as a first-class option in kdn.
  • Use Case: a team wants to support a custom container or VM runtime in their CI-driven development workflow by contributing a new runtime package.

Quick Start

Create a new runtime package under pkg/runtime/<runtime-name>/, implement the runtime interface, and register it in the runtimesetup so it becomes available to the CLI.

Frequently Asked Questions about add-runtime

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

FAQPage Schema
How do I add a new runtime backend to a Go CLI application?

To add a new runtime backend, create a package under pkg/runtime/<runtime-name>/, implement the Runtime interface methods (Type, DisplayName, Create, Start, Stop, Remove, Info), and register it in pkg/runtimesetup/register.go so it becomes available to the CLI.

What methods are required to implement a custom runtime interface in Go?

Implementing a custom runtime interface requires defining Type, DisplayName, Description, Local, WorkspaceSourcesPath, Create, Start, Stop, Remove, and Info methods, with Initialize and Available being optional additions for setup and availability checks.

Can I add a fake runtime for testing in a Go backend system?

Yes, you can add a fake runtime for testing by creating a new package under pkg/runtime/<runtime-name>/, implementing the required Runtime interface methods, and wiring it into the registry so it appears as a first-class option for CI-driven workflows.

How do I register a newly created Podman or MicroVM runtime in the kdn system?

Register a new Podman or MicroVM runtime by updating pkg/runtimesetup/register.go after creating the runtime package and implementing its interface methods, ensuring it is wired into the manager and available as a backend option.

Does adding a custom runtime require external dependencies?

No external dependencies are required to add a custom runtime, as the skill focuses on implementing the Runtime interface methods and updating the internal runtimesetup registry to integrate the new backend natively into the existing system.