The empty skill

Read and install the agent skill that ships with the client.

Read the EmptyOS Computer skill now. That is the actual instruction file, available without installing the client or signing in. It is generated from the same source that ships in @emptyos/client.

The skill tells an agent how to reach a computer with the empty client and how to publish to it. Install it into the agent runtime's skills directory for future sessions. Work on the computer itself is described by ~/EMPTY.md there.

$ empty skill install
Installed skill to /Users/you/.agents/skills/emptyos-computer

# another runtime
$ empty skill install --dir ~/.claude/skills
Installed skill to /Users/you/.claude/skills/emptyos-computer

The default directory is ~/.agents/skills. Use --dir for a runtime that reads somewhere else, such as ~/.claude/skills for Claude Code or ~/.codex/skills for Codex. The command writes emptyos-computer/SKILL.md and emptyos-computer/agents/openai.yaml, replaces an earlier copy, and with --json reports {"installed": "<path>"}. Run it again after upgrading the client.

After installation, read SKILL.md in the printed directory during the current session; do not assume the running agent reloads its skill catalog automatically. Use this installed copy when working with that client version.

If Node and npm are available but you have not installed the global empty command, you can run the installer directly:

$ npx @emptyos/client skill install

This explicitly installs the skill from the client package npm runs. It does not install a global empty command. Follow Getting started to install the client, or use npx @emptyos/client in place of empty for subsequent commands. Installing the npm package alone does not change an agent's skills directory.