Skip to content

Adancurusul/serial-mcp-server / skills/serial-debug

serial-debug

Verified

CLI-first serial port debugging and macro automation with serial-mcp-server for Codex and Claude Code. Use when working with UART or USB-serial devices, listing serial ports, probing STM32/Arduino/ESP32 boards, writing or reading serial data, running JSON serial macros, controlling RTS/DTR, or using serial-mcp-server through MCP tools.

FileKindSize
SKILL.mdskill md2.6 KB
agents/openai.yamlconfig192 B
references/cli.mdmarkdown3.2 KB
references/hardware-safety.mdmarkdown1.1 KB
references/mcp.mdmarkdown2.2 KB
references/troubleshooting.mdmarkdown1.1 KB

references/hardware-safety.md

View on GitHub
# Hardware Safety

Serial debugging can change device state. Be explicit about the port, baud rate, and control-line intent before touching hardware.

## Checks Before Writing

- Confirm the selected port name comes from `serial-mcp-server list-ports --json`.
- Confirm voltage compatibility between the adapter and target board, including 5 V tolerance.
- Confirm the protocol baud rate, data bits, parity, stop bits, and flow control.
- Avoid sending reset, erase, bootloader, or firmware-update commands unless the user requested that operation.

## RTS and DTR

RTS and DTR are often wired to reset or boot mode on development boards. Before using `set-control-lines`, mention that the line change can reset or reconfigure the target if the adapter wiring uses those pins.

Use explicit levels:

```bash
serial-mcp-server set-control-lines --port <port> --rts high --dtr low --json
```

## Evidence Boundaries

If no device is connected, report CLI availability and port discovery as the verified scope. Hardware validation summaries should stay limited to commands that ran against a connected device.
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall