chsh-sk-ncs-env

Configures Nordic NCS toolchain environments and executes west build, flash, and update commands.

1|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/chshzh/claude --skill chsh-sk-ncs-env-chshzh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: chsh-sk-ncs-env
Source: https://github.com/chshzh/claude/tree/main/skills/chsh-sk-ncs-env
Command: npx skills add https://github.com/chshzh/claude --skill chsh-sk-ncs-env-chshzh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Running west commands for nRF Connect SDK projects fails when the correct toolchain and SDK environment are not configured, and SDK versions and toolchain versions are easy to confuse. This Skill ensures every west command runs inside the correct Nordic toolchain environment. ## Core Features & Use Cases - Environment Setup: Resolves toolchain bundle IDs from toolchains.json, exports PATH and GIT_EXEC_PATH, and sources zephyr-env.sh before any west command. - Board Target Reference: Provides fully qualified board targets (e.g., nrf5340dk/nrf5340/cpuapp, nrf54l15dk/nrf54l15/cpuapp) and build directory conventions. - Troubleshooting: Covers nanopb/protobuf failures, Kconfig choice overrides, git priority issues, sysbuild control, and VCOM/UART logging defaults. - Use Case: When asked to build an nRF project with the NCS main branch, the Skill sets up the v3.2.4 toolchain, pulls the latest nrf repository, runs west update, and builds with the correct board target. ## Quick Start Ask the assistant to build your nRF project at a given path using a specific NCS toolchain version and SDK path.

Frequently Asked Questions about chsh-sk-ncs-env

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

FAQPage Schema
How do I run west build with a specific NCS toolchain version?

Use nrfutil sdk-manager toolchain launch --ncs-version=<version> -- west build to run the command inside the correct toolchain. Alternatively, export the toolchain bin directory to PATH and source zephyr-env.sh from your SDK path first.

What is the difference between NCS SDK version and toolchain version?

The SDK is the nRF Connect SDK source code, while the toolchain provides build tools like west, cmake, and compilers identified by bundle IDs. They can differ, for example using NCS main branch source with the v3.2.1 toolchain.

How do I find the correct board target for my Nordic DK?

Use the fully qualified board target format <board>/<soc>[/<variant>], such as nrf5340dk/nrf5340/cpuapp or nrf54l15dk/nrf54l15/cpuapp. Run west boards inside the toolchain environment to list all valid targets.

Why does west build fail with nanopb protobuf plugin errors?

The toolchain's bundled Python picks up a newer protobuf or grpcio-tools package from your user site-packages, which is incompatible with the older nanopb generator. Export PYTHONNOUSERSITE=1 before running west build to isolate the toolchain Python.

Why does my Kconfig choice setting keep reverting in prj.conf?

Another Kconfig default is winning at merge time. Explicitly set the losing choice members to n alongside enabling your choice, or force it via a CMake cache variable with west build -- -DCONFIG_NEWLIB_LIBC=y.

Why does west update fail with git errors in my terminal?

The system git at /usr/bin/git takes priority over the toolchain git because the toolchain bin directory was appended rather than prepended to PATH. Export the toolchain bin directory to the front of PATH and run hash -r to fix it.