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 BAOCHIP volume;
  • 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 xous to 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.md in the repository micovi/benchlink. Install it with npx skills add micovi/benchlink --skill benchlink, or copy the folder skills/benchlink into your skills folder. Once it is on the main branch, the file is also at https://raw.githubusercontent.com/micovi/benchlink/main/skills/benchlink/SKILL.md.
  • Every page of this site is also plain Markdown: /index.md and /wiki/<page>.md, this one at /wiki/agent-skills.md. /llms.txt lists them. Commands has every command and flag.
  • Check the CLI first: benchlink --version. Then benchlink status; the Dabao is powered when target reads 2,500 mV or more.
  • The CLI has no JSON output. status prints key=value pairs; the other commands print nothing on success and exit 0; errors go to stderr with exit code 1.
  • benchlink console runs until it is stopped. Bound it, for example timeout 20 benchlink console --log boot.log, and stop it before benchlink 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 benchlink command can short or back-feed the Dabao; that is the board’s safety rule. A failed step can be tried again.