# Skills And Commands

## Endpoint Summary

| Method | Path | Purpose |
| --- | --- | --- |
| `GET` | `/v1/skills` | List skills |
| `GET` | `/v1/skills/{name}` | Load skill content |
| `GET` | `/v1/commands` | List slash commands |
| `POST` | `/v1/commands/{cmd}` | Execute a slash command in an isolated subprocess |

## Skills

Omnius discovers skills from:

- AIWG package frameworks, addons, and plugins.
- AIWG user data frameworks, addons, and plugins.
- Project `.aiwg/skills`.
- Project `.aiwg/commands`.
- Project-local AIWG bundles: `.aiwg/addons/*/skills`, `.aiwg/extensions/*/skills`, `.aiwg/frameworks/*/skills`, `.aiwg/plugins/*/skills`.
- Project `.omnius/skills`.

The REST docs bundle is available as:

```text
omnius-rest-docs
```

Use `/v1/skills/omnius-rest-docs` or the agent tool `skill_execute`.

## Commands

Command execution is isolated in a subprocess and subject to command policy. Dangerous or denied commands require admin controls and may be blocked by profile policy.

## Small-Context Pattern

For agents:

1. Use `skill_list` or `/v1/skills` to find the skill.
2. Load only the specific skill that matches the current task.
3. Use `skill_extract` where available to pull targeted sections instead of full documents.
