Skills commands - Omni CLI

Create and manage skills, reusable instructions you run in Omni Agent chat with a slash command.

The skills API is experimental. These commands and their response fields can change without a deprecation cycle.

omni skills <command>

Command	Description
`list`	List the skills you can see
`create`	Create a skill
`get`	Get a skill, including its instructions
`update`	Update a skill
`delete`	Delete a skill

Organization Admins can see and edit every skill in the organization. Other users see and edit only their own skills. Skills must be enabled for you to use these commands. A skill’s identifier is its slash-command handle without the slash: lowercase letters, numbers, and hyphens, up to 48 characters, and unique among the organization’s skills. create requires name, identifier, description, and body, the instructions the agent follows when the skill runs.

# Print the create request body's shape
omni skills create --schema

# Create a skill that runs as /quarterly-report
omni skills create --body '{"name":"Quarterly report","identifier":"quarterly-report","description":"Summarizes the quarter and flags anything off trend.","body":"Pull revenue by month for the last four quarters, then call out any month more than 10% off trend."}'

# Find a skill by its identifier
omni skills list --identifier quarterly-report

# Change only the description, using the id from list; omitted fields are left alone
omni skills update <skill-id> --body '{"description":"Summarizes the quarter for the leadership sync."}'

# View help for list command, including pagination and sort flags
omni skills list --help

list omits body, so use get to read a skill’s instructions. Creating a skill with an identifier that another skill already holds fails with a 409. Deleting a skill removes it from every read and frees its identifier for reuse.

Every command in this group also accepts the global flags, including --token, --profile, --format, and --compact.

Getting started

Command groups

Reference

Skills commands - Omni CLI