zmk-config

Manage ZMK firmware configuration files for the Sofle split keyboard.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/caophuoclong/zmk-config --skill zmk-config
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: zmk-config
Source: https://github.com/caophuoclong/zmk-config/tree/main/.github/skills/zmk-config
Command: npx skills add https://github.com/caophuoclong/zmk-config --skill zmk-config

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a comprehensive guide and framework for developing and modifying ZMK firmware configurations, specifically for the Sofle split keyboard with Nice Nano v2 controllers, enabling users to customize their keyboard's behavior and settings.

Core Features & Use Cases

  • Firmware Customization: Modify keymaps, layers, macros, and behaviors using Devicetree syntax.
  • System Settings: Adjust Kconfig parameters for power, Bluetooth, RGB, and more.
  • Build Management: Understand and configure the build matrix for firmware compilation.
  • Use Case: A user wants to remap their keys to a custom layout, add a new layer for media controls, and enable RGB underglow on their Sofle keyboard. This Skill guides them through modifying the sofle.keymap and sofle.conf files, and explains how to rebuild the firmware.

Quick Start

Modify the config/sofle.keymap file to change key bindings on the default layer.

Frequently Asked Questions about zmk-config

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

FAQPage Schema
How do I configure ZMK firmware keymaps for a Sofle split keyboard?

To configure ZMK firmware keymaps for a Sofle split keyboard, you modify the Devicetree syntax within the `sofle.keymap` file to customize key bindings, layers, macros, and behaviors.

What system settings can I adjust in ZMK for a Sofle keyboard?

In ZMK for a Sofle keyboard, you can adjust system Kconfig parameters within the `sofle.conf` file to manage power, Bluetooth, RGB underglow, and other hardware-level settings for Nice Nano v2 controllers.

How do I add a new layer for media controls in ZMK firmware?

To add a new layer for media controls in ZMK firmware, you define the new layer and assign media behaviors using Devicetree syntax in your `sofle.keymap` configuration file.

Can I use ZMK firmware configuration with Nice Nano v2 controllers on a split keyboard?

Yes, ZMK firmware configuration explicitly supports the Nice Nano v2 hardware controllers, allowing you to manage build matrices and customize system parameters for Sofle split keyboards.

What is the best way to manage ZMK build matrices for custom keyboard firmware?

The best way to manage ZMK build matrices is by configuring the build matrix settings to compile custom keyboard firmware, ensuring all Devicetree keymaps and Kconfig parameters are included.

Why does my ZMK keymap configuration not apply after modifying the Sofle keyboard files?

If your ZMK keymap configuration is not applying, ensure your Devicetree syntax in the `sofle.keymap` file is correct and that you have rebuilt the firmware using the proper build matrix.