Adancurusul/serial-mcp-server / skills/serial-debug
serial-debug
VerifiedCLI-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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.6 KB |
| agents/openai.yaml | config | 192 B |
| references/cli.md | markdown | 3.2 KB |
| references/hardware-safety.md | markdown | 1.1 KB |
| references/mcp.md | markdown | 2.2 KB |
| references/troubleshooting.md | markdown | 1.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.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |