Agent Skills › opskat/opskat › serial

serial

GitHub

通过本地串口控制台向网络设备（如交换机、防火墙）发送命令并收集输出。需用户预先建立终端连接，适用于底层硬件交互与运维自动化场景。

internal/ai/skills/serial/SKILL.md opskat/opskat

触发场景

需要执行网络设备底层命令行操作通过串口调试或配置网络硬件

安装

npx skills add opskat/opskat --skill serial -g -y

更多选项

非标准路径

npx skills add https://github.com/opskat/opskat/tree/main/internal/ai/skills/serial -g -y

不安装直接使用

npx skills use opskat/opskat@serial

指定 Agent (Claude Code)

npx skills add opskat/opskat --skill serial -a claude-code -g -y

安装 repo 全部 skill

npx skills add opskat/opskat --all -g -y

预览 repo 内 skill

npx skills add opskat/opskat --list

SKILL.md

Frontmatter

{
    "name": "serial",
    "description": "Send commands to a serial console device (switch, firewall) via exec. Requires an already-connected desktop serial session."
}

Serial assets

Command syntax

Pass the console command verbatim as command:

display version
show ip interface brief
display current-configuration

Notes

The serial session must already be connected by the user in a terminal tab. There is no way to open one from here.
Output is collected until the line goes quiet (2s) or a 15s cap is reached.
Serial assets are unavailable from opsctl; they require the desktop app.
The scope parameter is not used by serial assets.

Asset config (for put_asset)

No host/port/username/credentials — a serial asset addresses a local device path instead.

field	type	required	notes
`port_path`	string	yes	e.g. `"COM3"` on Windows, `"/dev/ttyUSB0"` / `"/dev/cu.usbserial-XYZ"` on Linux/macOS
`baud_rate`	number	yes	e.g. `9600`, `115200`
`data_bits`	number	no	`5`-`8`, defaults to `8`
`stop_bits`	string	no	`"1"` (default), `"1.5"`, or `"2"`
`parity`	string	no	`"none"` (default), `"odd"`, `"even"`, `"mark"`, or `"space"`
`flow_control`	string	no	`"none"` or `"hardware"` (RTS/CTS); empty means no flow control
`password`	string	no	Reserved compatibility key; any non-empty value is rejected as inapplicable
`credential_id`	number	no	Reserved compatibility key; any non-zero value is rejected as inapplicable