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/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.
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: 197k | Updated | Claude CodeCodex | Verified | Install |