> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omni.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills commands - Omni CLI

> Reference for the omni skills command group: create and manage Omni Agent skills.

Create and manage [skills](/ai/skills), reusable instructions you run in Omni Agent chat with a slash command.

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

```bash wrap theme={null}
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.

```bash wrap theme={null}
# 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.

<Note>
  Every command in this group also accepts the [global flags](/developers/cli/reference/global-flags), including `--token`, `--profile`, `--format`, and `--compact`.
</Note>