skills: Introduce cdba Codex skill

[quic-bjorande]

cdba can be used directly from e.g. Codex to integrate board automation tasks in the agent's workflow. Introduce the cdba Codex skill to facilitate this.

[superna9999]

I don't understand why this is actually needed, because 99% of SKILL.md should be in the main README file. Please just move all this to the main README and just reference for to whatever AI agent needs it.

[andersson]

Are you suggesting that I have a SKILL that states that the information needed is in the README, or that I just tell the agent to go read the README when I want it to use cdba?

You're right in that a fair amount of the actual information does belong in the README, but there's some things which I've added just to counter non-human behavior.

[superna9999]

Are you suggesting that I have a SKILL that states that the information needed is in the README, or that I just tell the agent to go read the README when I want it to use cdba?

The SKILL is written in human language and is actually very useful for humans for a README with plenty of example & so on.

You're right in that a fair amount of the actual information does belong in the README, but there's some things which I've added just to counter non-human behavior.

The only one I see is:

- Never invoke multiple `cdba` commands in parallel for the same host and board (for example, do not run `-l` and `-i` concurrently for one target).

And this is simply not true, running the same command in parallel for the same host and board will simply wait for the board to be released by the other user. Just document this fact.

I'm kind of annoyed of those imperative "Do ..", "Do not...", "Keep ...", "Use ..." sentences which could be normal sentences like:

• The next cdba command should be started only after the previous one has fully exited and its result has been handled.
• The cdba operations should be treated as single-flight for a host/board pair.
• Do not redirect or pipe interactive cdba output (>, >>, |, tee) unless the use-case explicitly requires it.
• The process should be kept in a TTY/session that allows sending keys and seeing UART output in real time.
• stdin is used to interact with the board and to exit cleanly with Ctrl+a, then q.

Why would be instruct and document the tool differently for humans and LLM agents ???