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/troubleshooting.md

View on GitHub
# Troubleshooting

## No Ports Found

Run:

```bash
serial-mcp-server list-ports --json
```

Check cable, adapter driver, permissions, and whether another tool already owns the port.

## Port Open Fails

- Verify the port name exactly matches discovery output.
- Close serial monitors, flashing tools, or old MCP sessions using the same port.
- Try the known protocol baud rate instead of the default.
- On Unix-like systems, check device permissions for `/dev/tty*` or `/dev/cu*`.

## Read Times Out

- Confirm the target firmware actually writes serial output.
- Increase `--timeout-ms`.
- Check line endings and whether the device expects a command terminator.
- For request/response protocols, write first with `--read`.

## Data Looks Wrong

- Recheck `--format`.
- Use `--format hex` when bytes are not valid UTF-8.
- Confirm baud, parity, stop bits, and flow control.

## Control Lines Do Not Behave As Expected

- Confirm adapter wiring for RTS and DTR.
- Check whether the target inverts or routes the lines through reset or boot circuitry.
- Treat the CLI response as requested state evidence, not as electrical measurement evidence.
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: 197kUpdated Claude CodeCodexVerifiedInstall