How do I install the Ucx Development skill?

Run npx skillmds@latest add openucx/ucx-development in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Ucx Development safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Ucx Development?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Ucx Development free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Ucx Development?

openucx (@openucx) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Ucx Development by openucx — Agent Skill

Name: Ucx Development
Author: openucx

File contents

UCX Development

Overview

Use this skill for changing UCX itself. Durable code rules live in AGENTS.md files and project docs; this skill defines the end-to-end development workflow, including build and test commands.

Required Reading

Before editing or judging code:

Follow the AGENTS.md discovery rule from the root guide.
Read docs/CodeStyle.md, docs/LoggingStyle.md, or docs/OptimizationStyle.md when the change touches style, logging, or performance-sensitive code.
Read REVIEW.md when matching UCX reviewer expectations matters.

Edit Workflow

Identify the owning subtree and nearby implementation pattern before editing.
Apply the rules from the applicable AGENTS.md files and project docs.
Make the code or test change.
Build UCX or explain why the local environment cannot build it.
Run focused tests that cover the changed behavior.
Report the build/test commands used and any hardware, optional dependency, or coverage gaps.

Build

The two main helpers are configure-devel and configure-release: pick configure-devel for failure investigation, debug-oriented and feature work (logging, assertions, gtest, and valgrind enabled), configure-release for performance work (those checks disabled and optimized for speed).

From a fresh checkout, create an out-of-source build:

./autogen.sh
mkdir -p build-<flavor>  # <flavor> is "devel" or "release"
cd build-<flavor>
../contrib/configure-<flavor> --prefix=$PWD/install
make -j$(nproc)
make install

Run autogen.sh and configure once per build directory. For incremental builds, run make -j$(nproc) again from build-<flavor>; use make clean before a fresh rebuild when necessary.

Prefer repository configure helpers over ad hoc flag sets. If a dependency or optional transport is unavailable, report the missing capability instead of editing around it.

When build configuration details matter, inspect autogen.sh, contrib/configure-devel, configure.ac, and config/m4.

Unit Tests

From build-devel, run the C++ unit test target with:

make -C test/gtest test

Use make check when broader automake test coverage is needed.

Result Interpretation

Capture the command, failing test name, relevant log lines, and environment variables.
Distinguish test failures from unavailable optional dependencies or hardware.
Do not hide flakes behind broad reruns. If a rerun is useful, say whether the failure reproduced.

---name: ucx-developmentdescription: Develop, build, and test UCX code. Use when asked to change UCX internals, compile UCX, run UCX tests, or report verification coverage.---# UCX Development## OverviewUse this skill for changing UCX itself. Durable code rules live in `AGENTS.md`files and project docs; this skill defines the end-to-end development workflow,including build and test commands.## Required ReadingBefore editing or judging code:- Follow the `AGENTS.md` discovery rule from the root guide.- Read `docs/CodeStyle.md`, `docs/LoggingStyle.md`, or `docs/OptimizationStyle.md` when the change touches style, logging, or performance-sensitive code.- Read `REVIEW.md` when matching UCX reviewer expectations matters.## Edit Workflow1. Identify the owning subtree and nearby implementation pattern before editing.2. Apply the rules from the applicable `AGENTS.md` files and project docs.3. Make the code or test change.4. Build UCX or explain why the local environment cannot build it.5. Run focused tests that cover the changed behavior.6. Report the build/test commands used and any hardware, optional dependency, or coverage gaps.## BuildThe two main helpers are `configure-devel` and `configure-release`: pick `configure-devel` for failure investigation, debug-oriented and feature work (logging, assertions, gtest, and valgrind enabled), `configure-release` for performance work (those checks disabled and optimized for speed).From a fresh checkout, create an out-of-source build:```sh./autogen.shmkdir -p build-<flavor> # <flavor> is "devel" or "release"cd build-<flavor>../contrib/configure-<flavor> --prefix=$PWD/installmake -j$(nproc)make install```Run `autogen.sh` and configure once per build directory. For incrementalbuilds, run `make -j$(nproc)` again from `build-<flavor>`; use `make clean`before a fresh rebuild when necessary.Prefer repository configure helpers over ad hoc flag sets. If a dependency or optional transport is unavailable, report the missing capability instead of editing around it.When build configuration details matter, inspect `autogen.sh`,`contrib/configure-devel`, `configure.ac`, and `config/m4`.## Unit TestsFrom `build-devel`, run the C++ unit test target with:```shmake -C test/gtest test```Use `make check` when broader automake test coverage is needed.## Result Interpretation- Capture the command, failing test name, relevant log lines, and environment variables.- Distinguish test failures from unavailable optional dependencies or hardware.- Do not hide flakes behind broad reruns. If a rerun is useful, say whether the failure reproduced.

Frequently asked questions

Ucx Development