A comprehensive serial port debugging toolkit that handles everything from port scanning to live monitoring, hex viewing, and logging. It automatically detects available ports when you don't specify one, supports both text and binary protocols, and includes a multiplexing server so you can run minicom and monitoring scripts simultaneously without port conflicts. The config priority chain (CLI args, workspace config, state file, defaults) is sensible, and it persists your working parameters back to the project config after successful runs. Built for embedded work with AT commands, UART debugging, and MCU output inspection. The mux architecture using socat and TCP broadcast is clever but watch out for write collisions if multiple clients try sending at once.

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

Install

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

Installs into .claude/skills of the current project.

Files

Serial — 嵌入式串口调试工具

统一封装端口发现、实时监控、数据发送、日志记录和 Hex 查看能力。

配置

环境级配置 (skill/config.json)

serial skill 的环境级配置目前为空对象 {},因为串口参数属于工程级配置,统一在工作区的 .embeddedskills/config.json 中管理。

工程级配置 (.embeddedskills/config.json)

工作区下的 .embeddedskills/config.json 存放工程级串口配置:

{
  "serial": {
    "port": "",
    "baudrate": 115200,
    "bytesize": 8,
    "parity": "none",
    "stopbits": 1,
    "encoding": "utf-8",
    "timeout_sec": 1.0,
    "log_dir": ".embeddedskills/logs/serial"
  }
}
字段说明默认值
port串口号,如 COM3""
baudrate波特率115200
bytesize数据位8
parity校验位:none/even/odd/mark/spacenone
stopbits停止位:1/1.5/21
encoding文本编码utf-8
timeout_sec读写超时(秒)1.0
log_dir日志输出目录.embeddedskills/logs/serial

参数解析优先级

  1. CLI 参数 (--port, --baudrate 等) - 最高优先级
  2. 工程级配置 (.embeddedskills/config.json 中的 serial 部分)
  3. 状态文件 (.embeddedskills/state.json 中的历史记录)
  4. 默认值 - 最低优先级

自动扫描行为

当未指定 port 时,脚本会自动扫描系统串口:

  • 若只找到一个串口,自动使用该端口并写入工程配置
  • 若找到多个串口,返回候选列表让用户选择(通过 --port 指定)
  • 若未找到串口,提示错误

子命令

Sponsors

Details

Repository
github.com/zhinkgit/embeddedskills
First seen
Jun 3, 2026

More from zhinkgit/embeddedskills

All 9

Recommended

1juliusbrussee avatarcavemanjuliusbrussee/cavemanUltra-compressed communication mode. Cuts output tokens 65% (measured) by speaking like caveman while keeping full technical accuracy. Supports intensity levels618.3Kskills.sh installs
2mattpocock avatargrill-memattpocock/skillsA relentless interview to sharpen a plan or design.1.5Mskills.sh installs
3shadcn avatarimproveshadcn/improveSurvey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on s40Kskills.sh installs
4obra avatarsystematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes326.7Kskills.sh installs
5forrestchang avatarkarpathy-guidelinesforrestchang/andrej-karpathy-skillsBehavioral guidelines to reduce common LLM coding mistakes through explicit assumptions, simplicity, and verifiable success criteria.17.9Kskills.sh installs
6vercel-labs avatarfind-skillsvercel-labs/skillsHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express int4.3Mskills.sh installs