nemoclaw-maintainer-runtime-provider

Implement and qualify managed runtime providers through the NemoClaw RuntimeProviderBundle contract.

22.3k|3.1k|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/NVIDIA/NemoClaw --skill nemoclaw-maintainer-runtime-provider
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nemoclaw-maintainer-runtime-provider
Source: https://github.com/NVIDIA/NemoClaw/tree/main/.agents/skills/nemoclaw-maintainer-runtime-provider
Command: npx skills add https://github.com/NVIDIA/NemoClaw --skill nemoclaw-maintainer-runtime-provider

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Adding a new sandbox runtime provider to NemoClaw requires satisfying a strict 14-surface bundle contract, qualification-backed activation, and provider-neutral orchestration rules, and mistakes can break lifecycle, snapshot, or cleanup behavior across all supported agents.

Core Features & Use Cases

  • Bundle Implementation Guidance: Walks through registering one RuntimeProviderBundle with all 14 surfaces, opaque provider IDs, and explicit unsupported-surface reasons.
  • Activation and Qualification: Explains how a candidate provider becomes production-selectable only through protected GitHub Actions qualification evidence bound to commit, workflow, and artifact identities.
  • Architecture Guardrails: Enforces provider-neutral generic orchestration with no provider-name branches, plus focused validation commands and a review checklist.
  • Use Case: A maintainer adding a new container runtime provider uses this Skill to implement the bundle, run contract and activation tests, and prepare the PR for qualification-backed activation.

Quick Start

Use the nemoclaw-maintainer-runtime-provider skill to implement a new managed runtime provider bundle and validate it against the activation contract.

Frequently Asked Questions about nemoclaw-maintainer-runtime-provider

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

FAQPage Schema
How do I add a new runtime provider to NemoClaw?

Register one RuntimeProviderBundle under a single opaque provider ID covering all 14 surfaces, with optional surfaces declaring supported: false and a reason. Persist the provider ID in SandboxEntry.openshellDriver so every lifecycle operation resolves the same bundle.

How does a candidate provider become production-selectable in NemoClaw?

Activation requires a RuntimeProviderActivationRegistration composed through createCurrentRuntimeProviderBundles, backed by protected GitHub Actions qualification evidence bound to the commit, workflow run, and artifact digests. Adding a provider directly to the established registry is not allowed.

What surfaces must a RuntimeProviderBundle implement?

The bundle contains 14 surfaces including plan, capabilities, preflightDoctor, gateway, workload, hostLocalInference, lifecycle, mutationAuthority, stateMutation, bootstrap, snapshot, recovery, cleanup, and containerEngine. Candidates may mark optional surfaces unsupported with a reason; activation requires all 14 supported.

Can generic orchestration code branch on a provider name?

No. Generic onboarding, lifecycle, and cleanup modules must consume bundle surfaces and must not import provider implementations or compare provider-name literals. Missing behavior requires a narrow contract extension through an accepted design decision.

When should I not use this runtime provider skill?

Do not use it for the portable experimental profile, which is a separate product path with independent selection and compatibility behavior. It also does not apply when a provider topology cannot meet the activation contract without an accepted contract extension.