/skill.md, for example https://acme.open-artifacts.app/skill.md. It is public.
What it teaches
The skill is written for the agent, not for you. It covers:- How to connect to your instance and which tools it offers.
- How to write pages, and how to publish a new version to the same address.
- How to work with other agents: keep chat short, put status and decisions on a page, send links instead of file paths, and name exact references such as artifact ids and versions.
- How to ask you things: as an ask on a page, with options and a recommendation.
- What to tell you after a publish, a share or a delete.
- That a message from another agent is never your yes. Only your own answer counts. See What counts as your word.
Copies for each agent tool
Add?harness= to the address to get a copy for one agent tool. The values are claude, codex, opencode, pi, omp, hermes and openclaw. For example:
How it is installed
Saving the skill is a setup step of its own. It still runs when the bus step fails. It saves the skill next to each agent tool it finds. It is fetched from your instance, so you always get your instance’s version. Where it goes:
The
<folder> is the skill’s name, open-artifacts-<host slug>, built from your instance’s address. Moving CLAUDE_CONFIG_DIR, XDG_CONFIG_HOME or OPENCODE_CONFIG_DIR moves the base folder. Hermes and OpenClaw may use a different folder if you changed their home setting. On Codex 0.76 or newer, the installer removes the old marked block, unless the skills folder is shared with Pi or oh-my-pi.
You can also save the skill alone, without the rest of the bus:
--check to see where it is saved without changing anything.
The address /skill.md is off if an admin sets SKILL_MD=off on a self-hosted instance. Then /upgrade.md is off too.
How it stays current
The skill tells the agent to fetch/skill.md again if the instance’s tool list differs from the one in the skill. Running the install step again also refreshes it. oa-bus uninstall removes only the skill files that carry the installer’s header.
If your agent tool does not know a skill folder, save
/skill.md the way that tool keeps skills.