ncs-debug

Guide GDB/LLDB, RTT, and core-dump debugging for Nordic NCS applications.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps developers streamline debugging for Nordic NCS projects by providing structured guidance, best practices, and quick-start workflows to reduce time-to-debug.

Core Features & Use Cases

  • Interactive debugging guidance with GDB/LLDB for breakpoints, stepping, and variable inspection.
  • Real-Time Trace (RTT) and UART logging strategies to surface runtime information.
  • Core-dump and crash-analysis workflows to identify root causes efficiently.
  • Step-by-step workflows for building in Debug mode, flashing, attaching debuggers, and validating logs.

Quick Start

Use this skill to guide a new debugging session for an NCS project: confirm environment setup, build with debug symbols, flash the device, attach the debugger, and inspect logs.

Frequently Asked Questions about ncs-debug

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

FAQPage Schema
How do I debug Nordic NCS applications with GDB?

Debug Nordic NCS applications with GDB by building in Debug mode with the West toolchain, flashing the device, and attaching the debugger for breakpoints, stepping, and variable inspection. The skill provides structured guidance for interactive debugging sessions across supported boards and toolchains.

What is the best way to capture runtime logs from an NCS project?

Capture runtime logs from NCS projects using Real-Time Trace (RTT) and UART logging strategies. The skill guides you through flashing the device and validating logs to surface runtime information efficiently during crash analysis and runtime problem investigation.

How do I analyze a crash in a Nordic NCS firmware project?

Analyze NCS firmware crashes using core-dump and crash-analysis workflows to identify root causes efficiently. The skill provides step-by-step guidance for building with debug symbols, flashing, and interpreting crash data across supported boards and toolchains.

Do I need to configure prj.conf to enable debugging in NCS?

You need a properly configured NCS environment with the West toolchain and debug symbols enabled to use this skill. The skill requires building in Debug mode and configuring prj.conf before flashing and attaching the debugger for runtime inspection.

Can I use RTT logging instead of UART for debugging Nordic NCS apps?

RTT logging is supported alongside UART logging for debugging Nordic NCS apps. The skill covers Real-Time Trace strategies to surface runtime information, allowing you to choose the appropriate method for your supported board and toolchain during runtime problem investigation.

Why is my GDB debugger not attaching to my Nordic NCS board?

GDB may fail to attach if the NCS environment is not properly configured with debug symbols built via the West toolchain. The skill provides step-by-step workflows to confirm environment setup, build in Debug mode, flash, and attach debuggers correctly to resolve attachment issues.