Keil

This is a build orchestrator for Keil MDK embedded projects that scans for .uvprojx files, enumerates targets, runs build/rebuild/clean operations, and parses the logs to extract artifact paths. It's designed to sit between your Keil toolchain and downstream flashers like jlink or openocd, giving you structured JSON output instead of raw UV4 console noise. The configuration cascades from environment to workspace to CLI args, and it refuses to guess when multiple projects or targets exist, which is the right call. One thing to know: it won't modify your project files and blocks flashing if the last build had errors. Useful if you're automating Keil workflows or just tired of hunting through build logs for the hex file path.

skills.sh installs: 902
GitHub stars: 791
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add zhinkgit/embeddedskills --skill keil --agent claude-code

Installs into .claude/skills of the current project.

Files

Keil MDK 工程构建

本 skill 提供 Keil MDK 工程的发现、Target 枚举、构建、重建、清理能力，并返回可供 jlink/openocd 继续使用的固件产物路径。flash 仅作为兼容入口保留。

配置

环境级配置（skill/config.json）

skill 目录下的 config.json 包含环境级配置，首次使用前确认 uv4_exe 路径正确：

{
  "uv4_exe": "C:\\Keil_v5\\UV4\\UV4.exe",
  "operation_mode": 1
}

uv4_exe：UV4.exe 完整路径（必填）
operation_mode：1 直接执行 / 2 输出风险摘要但不阻塞 / 3 执行前确认

工程级配置（workspace/.embeddedskills/config.json）

工程级共享配置统一保存在工作区的 .embeddedskills/config.json 中：

{
  "keil": {
    "project": "",
    "target": "",
    "log_dir": ".embeddedskills/build"
  }
}

project：默认工程路径（相对 workspace），构建成功后会自动更新
target：默认 Target 名称，构建成功后会自动更新
log_dir：构建日志输出目录，默认 .embeddedskills/build

参数解析优先级

参数解析顺序（从高到低）：

CLI 显式参数
环境级配置（skill/config.json）
工程级配置（.embeddedskills/config.json）
.embeddedskills/state.json（上次构建记录）
搜索/询问

子命令

子命令	用途	风险
`scan`	搜索当前目录下的 .uvprojx/.uvproj/.uvmpw 工程	低
`targets`	枚举工程中的 Target	低
`build`	增量编译	中
`rebuild`	全量重建	中
`clean`	清理工程	高
`flash`	通过 Keil 烧录固件（兼容入口，优先建议使用 jlink/openocd）	高