$npx -y skills add easyzoom/aix-skills --skill nrf-connect-sdk-integrationUse when integrating, configuring, or debugging Nordic nRF Connect SDK, Zephyr-based nRF projects, BLE, SoftDevice Controller, Partition Manager, DFU, or nRF drivers
| 1 | # nRF Connect SDK Integration |
| 2 | |
| 3 | ## Overview |
| 4 | |
| 5 | Use this skill to debug nRF Connect SDK by combining Zephyr evidence with |
| 6 | Nordic-specific layers: board files, Partition Manager, Bluetooth controller, |
| 7 | DFU, security, and nrfx drivers. NCS issues often span multiple generated files. |
| 8 | |
| 9 | ## When To Use |
| 10 | |
| 11 | Use this skill when: |
| 12 | |
| 13 | - The user is working with nRF Connect SDK, nRF52/nRF53/nRF54/nRF91, VS Code |
| 14 | extension, `west`, or Zephyr-based Nordic samples. |
| 15 | - The issue involves BLE, SoftDevice Controller, MCUboot, DFU, Partition |
| 16 | Manager, TF-M, modem, nrfx, or board overlays. |
| 17 | - The app behavior depends on generated partitions, child images, or multi-core |
| 18 | images such as network core firmware. |
| 19 | |
| 20 | Do not use this skill for Zephyr-only boards with no Nordic-specific stack. Use |
| 21 | `zephyr-integration` instead. |
| 22 | |
| 23 | ## First Questions |
| 24 | |
| 25 | Ask for: |
| 26 | |
| 27 | - NCS version, Zephyr revision, SoC, board, sample/app, and build command. |
| 28 | - `prj.conf`, overlays, Partition Manager output, child images, and sysbuild use. |
| 29 | - Bluetooth role, controller settings, security/pairing, and connection logs. |
| 30 | - DFU/MCUboot setup, image slots, signing, and boot logs if update-related. |
| 31 | - Current build error, runtime log, fault dump, or radio behavior. |
| 32 | |
| 33 | ## Debug Workflow |
| 34 | |
| 35 | 1. Freeze SDK and build shape. |
| 36 | Confirm NCS version, board target, sysbuild, child images, and pristine build. |
| 37 | |
| 38 | 1. Inspect generated files. |
| 39 | Check `.config`, `zephyr.dts`, Partition Manager output, and image manifests. |
| 40 | |
| 41 | 1. Prove board and driver config. |
| 42 | Verify pins, clocks, regulators, nrfx drivers, and Nordic-specific Kconfig. |
| 43 | |
| 44 | 1. Debug BLE by layer. |
| 45 | Separate host APIs, controller config, advertising, connection parameters, |
| 46 | security, GATT, and radio coexistence. |
| 47 | |
| 48 | 1. Debug DFU by image chain. |
| 49 | Check MCUboot, signing, slot layout, image confirmation, and rollback state. |
| 50 | |
| 51 | 1. Handle multi-core devices explicitly. |
| 52 | For nRF53/nRF54, verify network core image, IPC, and core-specific logs. |
| 53 | |
| 54 | ## Common Failures |
| 55 | |
| 56 | - Partition Manager output differs from the assumed flash layout. |
| 57 | - Child image config overrides the parent app's assumptions. |
| 58 | - BLE controller options do not match role, PHY, or connection count. |
| 59 | - Network core firmware is missing or built from stale configuration. |
| 60 | - DFU image is signed correctly but not confirmed after first boot. |
| 61 | - TF-M or secure partition settings are changed without matching memory layout. |
| 62 | |
| 63 | ## Verification |
| 64 | |
| 65 | Before claiming NCS integration works: |
| 66 | |
| 67 | - State NCS version, board, build mode, and generated partition layout. |
| 68 | - Confirm `.config`, `zephyr.dts`, and child image evidence. |
| 69 | - Confirm BLE/DFU/modem logs for the exercised path. |
| 70 | - Confirm multi-core image status when using nRF53/nRF54 class devices. |
| 71 | |
| 72 | ## Example |
| 73 | |
| 74 | User: |
| 75 | |
| 76 | ```text |
| 77 | nRF5340 BLE 广播不出来。 |
| 78 | ``` |
| 79 | |
| 80 | Agent: |
| 81 | |
| 82 | 1. Checks NCS version, board target, child images, and network core firmware. |
| 83 | 1. Verifies Bluetooth host/controller config and generated logs. |
| 84 | 1. Tests a Nordic sample before changing application GATT code. |