Install any skill in seconds. Free to start, no credit card required.
Get Started Free →onyx-dot-app/onyx-cli
Query the Onyx knowledge base using the onyx-cli command.
Passed 24 of 25 test cases with the skill, and 7 of 25 without it.
and 21 more in the full report
19 fixed6 passed either way0 still failing1 broke
Tokens, turns and time describe resource use, not a dollar price.
One of 19 test cases the skill fixed. Same model, same prompt, with and without the skill.
Provide an Onyx CLI ask command to query 'What is our SLA for P1 tickets?' using the agent named 'Customer Support'.
| Checked | Without skill | With skill |
|---|---|---|
| Uses onyx-cli ask with --agent-name "Customer Support". | Missed | Passed |
The instructions your model reads when the skill loads.
onyx-cli is an agent's interface to the Onyx enterprise knowledge platform. It connects to company documents, apps, and people. Use it to answer questions that require internal knowledge — policies, docs, processes, data from connected sources (Confluence, Google Drive, Slack, etc.).
which onyx-cli
pip install onyx-cli
If a human has already run onyx-cli chat (which includes first-time setup), the CLI is ready — no additional setup needed. The config file at ~/.config/onyx-cli/config.json (or $XDG_CONFIG_HOME/onyx-cli/config.json if set) is read automatically.
Environment variables override the config file and can be used as an alternative when no config file exists:
export ONYX_SERVER_URL="https://your-onyx-server.com" # default: https://cloud.onyx.app
export ONYX_PAT="your-pat"
| Variable | Required | Description |
|---|---|---|
ONYX_SERVER_URL | No | Server origin or already-prefixed API base (default: https://cloud.onyx.app) |
ONYX_API_PREFIX | No | API path prefix (default: /api); empty for direct backend access |
ONYX_PAT | Yes | Personal access token for authentication (unless config file exists) |
ONYX_PERSONA_ID | No | Default agent/persona ID |
ONYX_STREAM_MARKDOWN | No | Enable/disable progressive markdown rendering (true/false) |
If neither a config file nor environment variables are set, tell the user that onyx-cli needs to be configured and ask them to either:
onyx-cli chat to complete first-time setup interactively, orONYX_SERVER_URL and ONYX_PAT environment variables (ONYX_PAT holds your PAT)test cases passed, vs 7 / 25 without
More skills from the same source and nearby in the registry, with their headline benchmark lift.