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-startedoo skill agent-workflows
Print references/agent-workflows.md: directory, asking another agent, jobs, agent creation, ownership, channels, schedules and secrets.
oo skill agent-workflowsoo skill chat-workflows
Print references/chat-workflows.md: conversations, Code sessions and files.
oo skill chat-workflowsoo skill service-workflows
Print references/service-workflows.md: services and cost, browsers, MCP accounts and hosted apps.
oo skill service-workflowsoo skill compute-workflows
Print references/compute-workflows.md: environments, machines, VMs, root grants and domains.
oo skill compute-workflowsoo skill access-workflows
Print references/access-workflows.md: people, keys, permissions, teams, sign-ins and approvals.
oo skill access-workflowsoo skill feedback
Print references/feedback.md: send feedback, receipts, team replies and submission failures.
oo skill feedbackoo skill operations-workflows
Print references/operations-workflows.md: Sunport settings, backups, agent rules and product boundaries.
oo skill operations-workflowsoo skill megabrain
Print references/megabrain.md: the company's own facts and earlier work: search, passages, quotes, audiences and stale claims.
oo skill megabrainoo skill api
Print references/api.md: identity, keys, permissions, jobs, transport and errors.
oo skill apioo skill overview
Print references/overview.md: the product's surfaces and what a Sunport is.
oo skill overviewoo skill agents-and-runtimes
Print references/agents-and-runtimes.md: templates, placement and agent state.
oo skill agents-and-runtimesoo skill chat-and-channels
Print references/chat-and-channels.md: access, pairing and conversation evidence.
oo skill chat-and-channelsoo skill models-and-usage
Print references/models-and-usage.md: served models, configuration and charges.
oo skill models-and-usageoo skill environments
Print references/environments.md: machines, lifetime and storage, spending caps, terminal, ports and Namespace operations.
oo skill environmentsoo skill list
List the skill and its references with their files, as JSON
oo skill listoo 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]| Argument | Required | Default | Choices | Description |
|---|---|---|---|---|
TOOL | no | claude, codex, gemini, opencode, devin, agents, pi, openclaw, hermes, claude-code, gemini-cli | claude, codex, gemini, opencode, devin, agents, pi, openclaw or hermes; leave it out for all | |
--project | no | install into the current directory's project, for TOOL | ||
--dir DIR | no | install into this skills folder instead | ||
--overwrite | no | also replace an openorange skill oo didn't write | ||
--refresh | no | only refresh the copies an oo wrote; install no new ones |