Skip to Content
Referenceoo CLI

oo skill

The openorange skill: how things work here, for you and your agent tools.

Print the openorange skill: how things work in a Sunport, for people and agents, and how to do it with oo.

oo skill prints the skill itself (SKILL.md), and oo skill DOC one of its references (references/DOC.md), which go deeper into one topic; oo skill list lists them as JSON. This oo carries the skill of its own version, so it works offline; the Sunport serves the same files at /cli/SKILL.md and /cli/references/.

oo skill install puts it where your agent tools read skills, so they open it by themselves when a request is about the Sunport. oo connect and the Sunport's oo installer run it, and oo update refreshes every copy an oo wrote.

oo skill getting-started

Print references/getting-started.md: installation, sign-in, remote agents, skill setup and discovery.

oo skill getting-started

oo skill agent-workflows

Print references/agent-workflows.md: directory, asking another agent, jobs, agent creation, ownership, channels, schedules and secrets.

oo skill agent-workflows

oo skill chat-workflows

Print references/chat-workflows.md: conversations, Code sessions and files.

oo skill chat-workflows

oo skill service-workflows

Print references/service-workflows.md: services and cost, browsers, MCP accounts and hosted apps.

oo skill service-workflows

oo skill compute-workflows

Print references/compute-workflows.md: environments, machines, VMs, root grants and domains.

oo skill compute-workflows

oo skill access-workflows

Print references/access-workflows.md: people, keys, permissions, teams, sign-ins and approvals.

oo skill access-workflows

oo skill feedback

Print references/feedback.md: send feedback, receipts, team replies and submission failures.

oo skill feedback

oo skill operations-workflows

Print references/operations-workflows.md: Sunport settings, backups, agent rules and product boundaries.

oo skill operations-workflows

oo skill megabrain

Print references/megabrain.md: the company's own facts and earlier work: search, passages, quotes, audiences and stale claims.

oo skill megabrain

oo skill api

Print references/api.md: identity, keys, permissions, jobs, transport and errors.

oo skill api

oo skill overview

Print references/overview.md: the product's surfaces and what a Sunport is.

oo skill overview

oo skill agents-and-runtimes

Print references/agents-and-runtimes.md: templates, placement and agent state.

oo skill agents-and-runtimes

oo skill chat-and-channels

Print references/chat-and-channels.md: access, pairing and conversation evidence.

oo skill chat-and-channels

oo skill models-and-usage

Print references/models-and-usage.md: served models, configuration and charges.

oo skill models-and-usage

oo skill environments

Print references/environments.md: machines, lifetime and storage, spending caps, terminal, ports and Namespace operations.

oo skill environments

oo skill list

List the skill and its references with their files, as JSON

oo skill list

oo skill install

Install the openorange skill, with its references, where each agent tool on this computer reads skills, or refresh it there.

Without TOOL it finds every tool by its folder in your home directory: Claude Code reads ~/.claude/skills; Codex, Gemini CLI, OpenCode and other Agent Skills readers ~/.agents/skills; Pi ~/.pi/agent/skills; OpenClaw ~/.openclaw/skills; and Hermes ~/.hermes/skills. A tool's own variable (CLAUDE_CONFIG_DIR, CODEX_HOME, PI_CODING_AGENT_DIR, OPENCLAW_STATE_DIR or HERMES_HOME) moves its folder. TOOL installs for that tool alone, even before it has a folder; --project installs into the current directory's project for TOOL, and --dir into any other skills folder.

Each copy holds a marker naming the oo that wrote it. oo replaces those copies with its own skill, and oo update refreshes them all; an openorange skill oo didn't write is left as it is unless --overwrite. It prints each skill's path and whether it was installed, updated, left unchanged or left alone.

oo skill install [options] [TOOL]
ArgumentRequiredDefaultChoicesDescription
TOOLnoclaude, codex, gemini, opencode, devin, agents, pi, openclaw, hermes, claude-code, gemini-cliclaude, codex, gemini, opencode, devin, agents, pi, openclaw or hermes; leave it out for all
--projectnoinstall into the current directory's project, for TOOL
--dir DIRnoinstall into this skills folder instead
--overwritenoalso replace an openorange skill oo didn't write
--refreshnoonly refresh the copies an oo wrote; install no new ones

On this page