Agent skills
The benchlink agent skill, which teaches a coding agent to power, reset, flash and read a Dabao on the bench link, and how to install and use it.
What the skill is
The benchlink skill is one file, skills/benchlink/SKILL.md in the repository, in the open Agent Skills format. Claude Code, Codex, Cursor and other agents that read skills load it when a task touches the board.
With it, an agent can drive a Dabao on the bench link through the benchlink CLI:
- check that the CLI is installed, and install it from the repository if not;
- read the status: the reset and PROG lines, power, the Dabao’s 3.3 V rail;
- switch the Dabao off, on, or off and on again, reset it, get it into
boot1; - flash UF2 images over the console UART or the
BAOCHIPvolume; - read the console for a bounded time, with the boot log from its first line, and send lines to it;
- act on the CLI’s error messages.
It also carries the rules: stop console before flash --uart, never move the Dabao while the board is plugged in, send boot1 only the lines the task needs.
Note
The skill cannot read the current the Dabao draws. The board has the monitor, but the firmware has no command for it yet. See Firmware.
Install it with a prompt
Paste this into your agent, in the folder you work in:
Install the benchlink agent skill. It is the folder skills/benchlink in the
GitHub repository micovi/benchlink. Run:
npx skills add micovi/benchlink --skill benchlink
If npx is not available, clone https://github.com/micovi/benchlink and copy
skills/benchlink into your skills folder (for Claude Code: ~/.claude/skills/).
Then check the benchlink CLI with `benchlink --version`. If it is missing,
install it as the skill's SKILL.md says. Last, run `benchlink status` and tell
me what it reports. Do not flash, reset or power-cycle the board.
Install it by hand
With Node, the skills installer finds the skill in the repository and copies it into each agent’s skills folder:
npx skills add micovi/benchlink --skill benchlink # this project
npx skills add micovi/benchlink --skill benchlink -g -a claude-code # every project, Claude Code
Without the installer, copy the folder yourself:
git clone https://github.com/micovi/benchlink
mkdir -p ~/.claude/skills
cp -R benchlink/skills/benchlink ~/.claude/skills/
| Agent | This project | Every project |
|---|---|---|
| Claude Code | .claude/skills/benchlink/ |
~/.claude/skills/benchlink/ |
| Codex | .agents/skills/benchlink/ |
~/.agents/skills/benchlink/ |
Start a new session after installing; agents read their skills when a session starts.
The skill drives the CLI, so the CLI has to be installed too. See Getting started.
Use it
Ask for the job in your own words. The agent loads the skill when the task names the board, the Dabao, flashing or the console. For example:
Flash loader.uf2, xous.uf2 and apps.uf2 from this folder onto the Dabao on
the bench link, then read its console for 20 seconds and tell me whether it
reached the shell. If anything fails, show me the error and the status line.
Other jobs it covers:
- “Reset the Dabao and show me its boot log.”
- “Power-cycle the Dabao and check that its 3.3 V rail comes back.”
- “Send
ver xousto the Dabao’s console and show me the answer.”
Instructions for agents
This section is for an agent reading the page.
- The skill is
skills/benchlink/SKILL.mdin the repositorymicovi/benchlink. Install it withnpx skills add micovi/benchlink --skill benchlink, or copy the folderskills/benchlinkinto your skills folder. Once it is on themainbranch, the file is also athttps://raw.githubusercontent.com/micovi/benchlink/main/skills/benchlink/SKILL.md. - Every page of this site is also plain Markdown:
/index.mdand/wiki/<page>.md, this one at/wiki/agent-skills.md./llms.txtlists them. Commands has every command and flag. - Check the CLI first:
benchlink --version. Thenbenchlink status; the Dabao is powered whentargetreads 2,500 mV or more. - The CLI has no JSON output.
statusprintskey=valuepairs; the other commands print nothing on success and exit 0; errors go to stderr with exit code 1. benchlink consoleruns until it is stopped. Bound it, for exampletimeout 20 benchlink console --log boot.log, and stop it beforebenchlink flash --uart.- Never seat, move or reseat the Dabao yourself. If it needs it, ask the person at the bench, who unplugs the bench link first.
- No
benchlinkcommand can short or back-feed the Dabao; that is the board’s safety rule. A failed step can be tried again.