Skills on your machines
A skill is a SKILL.md a coding tool loads when the work matches its description. Claude Code,
Codex, Cursor, Copilot, OpenCode, OpenClaw, pi, omp, JetBrains and Devin Desktop read the same set;
most share ~/.agents/skills. Claude Desktop installs them as plugins from your gateway's plugin
marketplace instead, whether managed or set up with anyray-connect.
The built-in anyray skill
Every enrolled machine gets a skill in a folder named anyray. It fires only when someone asks
about Anyray itself:
| Trigger | The agent does |
|---|---|
| "is my traffic going through Anyray", "nothing shows on the dashboard", a 401 after enrollment | Runs anyray-connect doctor --json and applies the remedy it names |
a truncated tool result with a ctx_ handle | Calls anyray_retrieve for the original bytes |
an anyray-hook footer naming a file under ~/.anyray/hook-tee, or … [N line(s) omitted by anyray · lines A-B] | Fetches the omitted lines if needed, and treats the footer as Anyray's, not tampering |
Without it, agents call trimmed content missing or stop to warn about tampering. It updates with your gateway.
Check it arrived
anyray-connect sync
The Skills section lists anyray. The console's Skills & Guidance card shows the gateway side:
| Card says | Meaning |
|---|---|
| Built in | The gateway is serving it |
| Not serving | The gateway could not read its Skills store in full, so it holds the Skill back and machines keep their copy |
| Needs gateway upgrade | This gateway predates the Skill |
The Machines page gives each seat an Anyray skill row:
| Row says | Meaning |
|---|---|
| ok | Installed, or the machine has nowhere to put one. A seat that never pulled it also reads ok |
| skill gone from a skills folder | It was written and then removed. Run anyray-connect sync on that machine |
Only the second flags the seat. To tell "installed" from "never pulled", read builtinSkill.kind
(with its remedy) from anyray-connect doctor --json.
New skills in Claude Code
Claude Code installs org skills as plugins from the gateway's marketplace. anyray-connect sync
also installs any org skill Claude Code has turned on but not installed, so a new skill works after
the next sync. If one is still missing, anyray-connect doctor lists it under Org Skills in
Claude Code with the commands to install it by hand.
Replace it with your own
Save a SKILL.md with name: anyray and a description in its front matter. Tools match on the
description, so use the words your developers would type.
In the console, open Connectors under Settings, then Skills. Choose Add, then Upload skill.
The Built in row disappears and yours takes its place. Machines pick it up on their next policy sync.
Removing your version brings the built-in back. There is no off switch.
Where the files are written
Connect writes <skills-dir>/<id>/SKILL.md and records the last version written in ~/.anyray, so
a re-run only touches what changed. Deleting a Skill in the console removes its folder from every
machine on the next sync. Claude Code installs organization plugins natively, so a plugin-derived
Skill is not duplicated there. Directories and the sync verb:
CLI commands.
Skill bodies download from a credential-free gateway URL. Never put credentials or anything you would not want on a contractor's laptop in one.