Skip to content
cccskills
FreePublished on GitHub

zmk

ZMK Firmware (オープンソースキーボードファームウェア) リファレンス。

Getting Started (hardware, user-setup, customization, zmk-cli)、 Features (bluetooth, split keyboards, encoders, displays, lighting, pointing, studio, low-power)、 Keymaps (keycodes, modifiers, combos, conditional layers)、 Behaviors (タップ・ホールド、レイヤー、マクロ、tap-dance, sticky-key)、 Input Processors、Hardware Integration、Troubleshooting (building, flashing, connection, hardware issues)。

The English summary is being prepared. Showing the original description.

See how to install

Files included (150)

  • SKILL.md9.1 KB
  • references/behaviors/backlight.md1.1 KB
  • references/behaviors/bluetooth.md1.7 KB
  • references/behaviors/caps-word.md1.3 KB
  • references/behaviors/hold-tap.md3.0 KB
  • references/behaviors/key-press.md1016 B
  • references/behaviors/key-repeat.md812 B
  • references/behaviors/key-toggle.md1.0 KB
  • references/behaviors/layers.md2.0 KB
  • references/behaviors/macros.md2.2 KB
  • references/behaviors/misc.md969 B
  • references/behaviors/mod-morph.md1.4 KB
  • references/behaviors/mouse-emulation.md1.8 KB
  • references/behaviors/outputs.md1002 B
  • references/behaviors/overview.md2.1 KB
  • references/behaviors/power.md1.1 KB
  • references/behaviors/README.md2.9 KB
  • references/behaviors/reset.md943 B
  • references/behaviors/sensor-rotate.md1.9 KB
  • references/behaviors/soft-off.md1.0 KB
  • references/behaviors/sticky-key.md1.5 KB
  • references/behaviors/sticky-layer.md907 B
  • references/behaviors/studio-unlock.md552 B
  • references/behaviors/tap-dance.md1.2 KB
  • references/behaviors/underglow.md1.5 KB
  • references/config/battery.md1.4 KB
  • references/config/behaviors.md4.2 KB
  • references/config/bluetooth.md1.3 KB
  • references/config/bootloader.md1.8 KB
  • references/config/combos.md1.6 KB
  • references/config/displays.md2.8 KB
  • references/config/encoders.md1.6 KB
  • references/config/keymap.md1.5 KB
  • references/config/kscan.md4.5 KB
  • references/config/layout.md3.3 KB
  • references/config/led-indicators.md1.5 KB
  • references/config/lighting.md2.7 KB
  • references/config/overview.md1.7 KB
  • references/config/pointing.md1.9 KB
  • references/config/power.md2.1 KB
  • references/config/README.md3.3 KB
  • references/config/settings.md1.6 KB
  • references/config/split.md2.8 KB
  • references/config/studio.md1.7 KB
  • references/config/system.md3.1 KB
  • references/contributing/clean-room.md841 B
  • references/contributing/documentation.md1.2 KB
  • references/contributing/pull-requests.md1.4 KB
  • references/contributing/README.md609 B
  • references/development/devicetree.md2.1 KB
  • references/development/events.md2.3 KB
  • references/development/module-creation.md1.8 KB
  • references/development/new-behavior.md5.2 KB
  • references/development/README.md1.1 KB
  • references/development/studio-rpc-protocol.md1.5 KB
  • references/development/usb-logging.md1.5 KB
  • references/features/battery.md627 B
  • references/features/bluetooth.md997 B
  • references/features/debouncing.md1.4 KB
  • references/features/displays.md510 B
  • references/features/encoders.md1.1 KB
  • references/features/led-indicators.md1.2 KB
  • references/features/lighting.md1.1 KB
  • references/features/low-power-states.md1.2 KB
  • references/features/modules.md1.4 KB
  • references/features/pointing.md1.0 KB
  • references/features/README.md1.8 KB
  • references/features/split-keyboards.md1.6 KB
  • references/features/studio.md1.8 KB
  • references/getting-started/customization.md2.0 KB
  • references/getting-started/faq.md2.3 KB
  • references/getting-started/hardware.md2.0 KB
  • references/getting-started/README.md1006 B
  • references/getting-started/user-setup.md1.7 KB
  • references/getting-started/zmk-cli.md2.3 KB
  • references/hardware-integration/battery.md1.4 KB
  • references/hardware-integration/bootloader/adafruit-nrf52.md1.7 KB
  • references/hardware-integration/bootloader/overview.md1.4 KB
  • references/hardware-integration/bootloader/README.md738 B
  • references/hardware-integration/bootloader/rp2.md1.6 KB
  • references/hardware-integration/bootloader/samd21-uf2.md2.2 KB
  • references/hardware-integration/bootloader/stm32.md1.7 KB
  • references/hardware-integration/bootloader/tinyuf2.md2.1 KB
  • references/hardware-integration/dongle.md6.1 KB
  • references/hardware-integration/encoders.md2.1 KB
  • references/hardware-integration/hardware-metadata-files.md1.8 KB
  • references/hardware-integration/lighting/backlight.md1.9 KB
  • references/hardware-integration/lighting/led-indicators.md1.8 KB
  • references/hardware-integration/lighting/overview.md1.1 KB
  • references/hardware-integration/lighting/README.md542 B
  • references/hardware-integration/lighting/underglow.md1.8 KB
  • references/hardware-integration/new-board.md2.1 KB
  • references/hardware-integration/new-shield.md3.8 KB
  • references/hardware-integration/overview.md2.8 KB
  • references/hardware-integration/physical-layouts.md3.4 KB
  • references/hardware-integration/pinctrl.md3.6 KB
  • references/hardware-integration/pointing.md3.1 KB
  • references/hardware-integration/README.md1.8 KB
  • references/hardware-integration/shift-registers.md2.1 KB
  • references/hardware-integration/soft-off-setup.md2.8 KB
  • references/input-processors/behaviors.md1.8 KB
  • references/input-processors/code-mapper.md1.7 KB
  • references/input-processors/overview.md2.3 KB
  • references/input-processors/README.md1.4 KB
  • references/input-processors/scaler.md2.2 KB
  • references/input-processors/temp-layer.md1.9 KB
  • references/input-processors/transformer.md2.2 KB
  • references/input-processors/usage.md1.7 KB
  • references/keymaps/combos.md2.2 KB
  • references/keymaps/conditional-layers.md1.5 KB
  • references/keymaps/keymap-example.md2.0 KB
  • references/keymaps/list-of-keycodes.md5.3 KB
  • references/keymaps/modifiers.md1.7 KB
  • references/keymaps/overview.md2.4 KB
  • references/keymaps/README.md987 B
  • references/local-toolchain/build-flash.md2.4 KB
  • references/local-toolchain/ide-integration.md1.4 KB
  • references/local-toolchain/posix-board.md814 B
  • references/local-toolchain/pre-commit.md1.1 KB
  • references/local-toolchain/README.md1.6 KB
  • references/local-toolchain/setup-container.md2.0 KB
  • references/local-toolchain/setup-native.md1.6 KB
  • references/local-toolchain/setup.md870 B
  • references/local-toolchain/tests.md1.2 KB
  • references/troubleshooting/building-issues.md2.0 KB
  • references/troubleshooting/connection-issues.md2.2 KB
  • references/troubleshooting/flashing-issues.md1.3 KB
  • references/troubleshooting/hardware-issues.md1.8 KB
  • references/troubleshooting/overview.md706 B
  • references/troubleshooting/README.md686 B
  • samples/basic-keymap.md1.1 KB
  • samples/bluetooth-profiles.md1.4 KB
  • samples/combos.md1.3 KB
  • samples/config-repo-setup.md1.6 KB
  • samples/encoder-volume-scroll.md1.4 KB
  • samples/hold-tap-homerow-mods.md1.5 KB
  • samples/layer-switching.md1.5 KB
  • samples/macros.md1.6 KB
  • samples/mod-morph.md1.5 KB
  • samples/README.md1.6 KB
  • samples/sticky-key.md1.5 KB
  • samples/tap-dance.md1.4 KB
  • scripts/build.md2.0 KB
  • scripts/cli.md1.2 KB
  • scripts/debug.md1.0 KB
  • scripts/dev-setup.md2.5 KB
  • scripts/docs.md779 B
  • scripts/flash.md809 B
  • scripts/install.md1.0 KB
  • scripts/README.md971 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

ZMK Firmware リファレンス

ZMK Firmware — Zephyr RTOS 上に構築されたオープンソース (MIT) のキーボードファームウェア。 省電力・無線・分割キーボード対応を主眼に設計され、devicetree ベースの宣言的設定により多様な MCU(nRF52/RP2/SAMD21/STM32 等)と shield をサポートする。 公式ドキュメント (zmk.dev/docs) の全 11 カテゴリを構造化。 keymap 設計・behaviors 選択・config 設定・新規 board/shield 作成・ローカルビルド・トラブルシューティング時に参照する。

出典は zmk.dev/docs (zmkfirmware/zmk main、commit 4dd95d7、2026-10-09 時点、取得日 2026-10-16)。最新リリース v0.3.0 は Zephyr 4.1 移行前でドキュメント構成が異なる。 board ID は Zephyr 4.1 の board variant 形式 <board>//zmk(例: nice_nano//zmk)を使用する。

ディレクトリ構成

skills/zmk/
  SKILL.md
  references/
    getting-started/
      README.md
      hardware.md
      user-setup.md
      zmk-cli.md
      customization.md
      faq.md
    features/
      README.md
      bluetooth.md
      split-keyboards.md
      encoders.md
      displays.md
      lighting.md
      pointing.md
      low-power-states.md
      studio.md
      modules.md
      led-indicators.md
      debouncing.md
      battery.md
    keymaps/
      README.md
      overview.md
      list-of-keycodes.md
      modifiers.md
      combos.md
      conditional-layers.md
      keymap-example.md
    behaviors/
      README.md
      overview.md
      key-press.md
      hold-tap.md
      tap-dance.md
      mod-morph.md
      sticky-key.md
      sticky-layer.md
      layers.md
      macros.md
      mouse-emulation.md
      sensor-rotate.md
      bluetooth.md
      outputs.md
      reset.md
      power.md
      soft-off.md
      caps-word.md
      key-repeat.md
      key-toggle.md
      backlight.md
      underglow.md
      studio-unlock.md
      misc.md
    input-processors/
      README.md
      overview.md
      usage.md
      code-mapper.md
      scaler.md
      temp-layer.md
      transformer.md
      behaviors.md
    config/
      README.md
      overview.md
      system.md
      bluetooth.md
      split.md
      kscan.md
      keymap.md
      combos.md
      behaviors.md
      encoders.md
      pointing.md
      displays.md
      lighting.md
      led-indicators.md
      studio.md
      battery.md
      power.md
      settings.md
      layout.md
      bootloader.md
    development/
      README.md
      devicetree.md
      events.md
      new-behavior.md
      module-creation.md
      studio-rpc-protocol.md
      usb-logging.md
    contributing/
      README.md
      clean-room.md
      documentation.md
      pull-requests.md
    hardware-integration/
      README.md
      overview.md
      new-board.md
      new-shield.md
      physical-layouts.md
      pinctrl.md
      hardware-metadata-files.md
      encoders.md
      dongle.md
      battery.md
      shift-registers.md
      soft-off-setup.md
      pointing.md
      bootloader/
        README.md
        overview.md
        adafruit-nrf52.md
        rp2.md
        samd21-uf2.md
        stm32.md
        tinyuf2.md
      lighting/
        README.md
        overview.md
        backlight.md
        underglow.md
        led-indicators.md
    local-toolchain/
      README.md
      setup.md
      setup-container.md
      setup-native.md
      build-flash.md
      ide-integration.md
      posix-board.md
      pre-commit.md
      tests.md
    troubleshooting/
      README.md
      overview.md
      building-issues.md
      flashing-issues.md
      connection-issues.md
      hardware-issues.md
  samples/
    README.md
    basic-keymap.md
    hold-tap-homerow-mods.md
    layer-switching.md
    combos.md
    macros.md
    tap-dance.md
    mod-morph.md
    sticky-key.md
    bluetooth-profiles.md
    encoder-volume-scroll.md
    config-repo-setup.md
  scripts/
    README.md
    install.md
    cli.md
    build.md
    flash.md
    dev-setup.md
    debug.md
    docs.md

探索手順

タスクからカテゴリを引き、カテゴリの README.md で目的のページを特定する:

  1. 下記マッピング表でタスクに対応するカテゴリを探す
  2. そのカテゴリの references/{category}/README.md を参照して目的のページを特定する
  3. 該当ページの .md を Read して詳細を確認する

タスク → カテゴリ マッピング

タスクカテゴリ参照 README
対応ハードウェア確認、ユーザーセットアップ、ZMK CLI の使い方getting-startedreferences/getting-started/README.md
.conf / .keymap / build.yaml のカスタマイズ、FAQgetting-startedreferences/getting-started/README.md
Bluetooth、Split keyboards、Encoders、Displays、Pointing 機能の有効化featuresreferences/features/README.md
Low Power、Studio、Modules、LED Indicators、デバウンス設定featuresreferences/features/README.md
keymap ファイル構造、keycodes 一覧、modifiers (LC/LS/LA/LG)keymapsreferences/keymaps/README.md
combos、conditional layers の設定keymapsreferences/keymaps/README.md
&kp / &mt / &lt / &mo / &sk / &sl / &td の挙動と設定behaviorsreferences/behaviors/README.md
&macro / &mmv / &mwh / &out / &bt / &rgb_ug / &reset / &soft_off の挙動と設定behaviorsreferences/behaviors/README.md
Pointing デバイス入力の変換(code-mapper, scaler, temp-layer, transformer)input-processorsreferences/input-processors/README.md
Kconfig (CONFIG_ZMK_*) の全オプション、devicetree プロパティリファレンスconfigreferences/config/README.md
kscan / split / BLE / encoders / lighting / settings / layout 設定configreferences/config/README.md
devicetree 基礎、events システム、新規 behavior 実装、USB loggingdevelopmentreferences/development/README.md
Zephyr モジュール作成、Studio RPC プロトコルdevelopmentreferences/development/README.md
Clean room ポリシー、ドキュメント編集、PR ガイドcontributingreferences/contributing/README.md
新規 board / shield 作成、physical layouts、pinctrl、dongle、shift-registershardware-integrationreferences/hardware-integration/README.md
battery 統合、soft-off setup、hardware metadata fileshardware-integrationreferences/hardware-integration/README.md
pointing device (trackpad, trackball) のハードウェア統合、input-listener / input-split 設定hardware-integrationreferences/hardware-integration/README.md
Adafruit nRF52 / RP2 / SAMD21-UF2 / STM32 / TinyUF2 bootloader のフラッシュ手順hardware-integration/bootloaderreferences/hardware-integration/bootloader/README.md
Backlight / Underglow (RGB) / LED Indicators のハードウェア統合hardware-integration/lightingreferences/hardware-integration/lighting/README.md
Container / Native セットアップ、west build / west flash、IDE 連携local-toolchainreferences/local-toolchain/README.md
posix-board、pre-commit、テスト実行local-toolchainreferences/local-toolchain/README.md
ビルドエラー、フラッシュ失敗、接続不良、ハードウェア不調のトラブルシューティングtroubleshootingreferences/troubleshooting/README.md
keymap の典型的な書き方・動作サンプルを知りたいsamplessamples/README.md
インストール・CLI・ビルド・フラッシュ・デバッグコマンドを知りたいscriptsscripts/README.md

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

AMD ROCm / HIP GPU コンピューティングリファレンス。 hipMalloc, hipLaunchKernelGGL, HIP Graph, hipGreenCtx, HIPRTC, hipify, rocBLAS, MIOpen, RCCL, hipThreads, libhipcxx, rocprofv3, amd-smi, rocminfo, TheRock / Core SDK 10, CDNA1-4 / RDNA1-4, MI300 / MI350 / MI350P, gfx942, Matrix Core, wave32/64。

The English summary is being prepared. Showing the original description.

Fandhe-AI/agent-reference-skills4Updated Oct 20, 2026

Android アプリ開発 (Kotlin) の推奨アーキテクチャリファレンス。 Jetpack, androidx, UI layer, Domain layer, Data layer, state holder, UDF, SSOT, オフラインファースト, モジュール化, ViewModel, viewModelScope, SavedStateHandle, Lifecycle, repeatOnLifecycle, collectAsStateWithLifecycle, LiveData, Hilt による DI, Paging 3 によるページング処理。

The English summary is being prepared. Showing the original description.

Fandhe-AI/agent-reference-skills4Updated Oct 20, 2026

Android アプリ開発 (Kotlin) のバックグラウンド・非同期処理リファレンス。 Jetpack androidx WorkManager: Worker, CoroutineWorker, WorkRequest, Constraints, WorkInfo, WorkContinuation, expedited work, テスト。 Service: フォアグラウンドサービス, バウンドサービス, AIDL, Messenger。 AlarmManager, PendingIntent, BroadcastReceiver, JobScheduler, Doze。 Kotlin コルーチン, Flow, StateFlow, SharedFlow, Channel。

The English summary is being prepared. Showing the original description.

Fandhe-AI/agent-reference-skills4Updated Oct 20, 2026

Android アプリ開発 (Kotlin) の Gradle ビルドシステムリファレンス。 Android Gradle Plugin (AGP), Kotlin DSL (build.gradle.kts), version catalog, KSP, R8/ProGuard, App Bundle, baseline profile。

The English summary is being prepared. Showing the original description.

Fandhe-AI/agent-reference-skills4Updated Oct 20, 2026

Android Jetpack Compose (Kotlin) の androidx Material3 コンポーネントリファレンス。 Button, IconButton, FloatingActionButton, Checkbox, Switch, Slider, TextField, SearchBar, DropdownMenu, Chip, DatePicker, TimePicker, Card, Scaffold, Dialog, BottomSheet, TopAppBar, NavigationBar, NavigationRail, Tab, Snackbar, ProgressIndicator, Badge, Icon, MaterialTheme, ColorScheme, Typography, Shapes。

The English summary is being prepared. Showing the original description.

Fandhe-AI/agent-reference-skills4Updated Oct 20, 2026

Android Jetpack Compose (Kotlin) のアニメーション・描画リファレンス。 androidx.compose.animation / graphics API。 AnimatedVisibility, AnimatedContent, animate*AsState, Animatable, AnimationSpec, Canvas, DrawScope, Brush, Path, Color, Image。

The English summary is being prepared. Showing the original description.

Fandhe-AI/agent-reference-skills4Updated Oct 20, 2026

See all skills by Fandhe-AI

Report a problem with this skill