cuopt-developer

Guide cuOpt core development with build, test, and contribution workflows.

Updated May 23, 2026
One-click install
npx skills add https://github.com/yo-steven/skills-exploration-20260522 --skill cuopt-developer-yo-steven
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cuopt-developer
Source: https://github.com/yo-steven/skills-exploration-20260522/tree/main/skills/cuopt/cuopt-developer
Command: npx skills add https://github.com/yo-steven/skills-exploration-20260522 --skill cuopt-developer-yo-steven

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you safely modify, build, test, and contribute to the NVIDIA cuOpt codebase by providing the correct development workflow and guardrails for solver internals, CI, and coding conventions.

Core Features & Use Cases

  • cuOpt core development guidance: Covers how to work on C++/CUDA, Python bindings, server components, and docs without breaking conventions.
  • Deterministic build & test workflow: Guides first-time setup, build commands, test commands, and the required pre-flight checks (CUDA compatibility, conda activation, dataset availability, and PARALLEL_LEVEL for OOM prevention).
  • Contribution hygiene & safety: Enforces non-negotiable rules (DCO signoff, minimal diffs, no CI bypass, no sudo/system edits, no destructive commands) and directs you to the right files for common change types (solver parameters, server endpoints, dependencies).

Quick Start

Start by asking what component and change you need (C++/CUDA, Python bindings, server, docs, or CI) and confirm the goal and tests required before running any build or code edits.

Frequently Asked Questions about cuopt-developer

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

FAQPage Schema
How do I build and test CUDA kernels for cuOpt core development?

Building and testing cuOpt CUDA kernels requires activating conda, verifying CUDA compatibility, setting PARALLEL_LEVEL to prevent OOM, and running canonical build and test commands before submitting any CI contributions.

What development rules must I follow to contribute to cuOpt internals?

Contributing to cuOpt internals requires strict adherence to DCO signoff, minimal diffs, and safety rules: no CI or pre-commit bypass, no sudo, no installs outside dependencies.yaml, and no destructive commands during PR preparation.

How do I add solver parameters or extend server endpoints in cuOpt?

Adding solver parameters or extending server endpoints in cuOpt requires modifying the correct internal files for your change type while following the end-to-end workflow for C++/CUDA, Python bindings, and server components without breaking conventions.

Why does my cuOpt build pipeline fail during pre-flight validation?

Your cuOpt build pipeline may fail if pre-flight checks are skipped, such as missing dataset availability, incorrect CUDA compatibility, inactive conda environments, or unset PARALLEL_LEVEL causing out-of-memory errors during the build process.

Can I bypass CI checks when debugging C++ development failures in cuOpt?

No, you cannot bypass CI checks or pre-commit hooks when debugging C++ development failures in cuOpt; the workflow enforces non-negotiable safety rules including no CI bypass, no sudo, and strict DCO signoff compliance.

What's the best way to prepare a cuOpt pull request without breaking CI conventions?

The best way to prepare a cuOpt pull request is to confirm your component and change type, run required pre-flight validations, ensure minimal diffs, apply DCO signoff, and verify all build and test commands pass locally before submission.