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

# Skills API: Manage Workspace and Agent Skills

> List, create, update, and delete the skills your agents load in a workspace with the OneCLI API.

Skills are instruction sets an agent loads to learn a task, such as how to call an internal API. A workspace sees the organization's skills, its own skills, and skills that belong to a single hosted agent.

Use these endpoints to manage workspace and agent skills from code. Organization skills are readable here, but you edit them through the organization endpoints. To teach coding agents about the gateway, see [Coding agents](https://onecli.sh/docs/guides/coding-agents.md).

## Related guides

* [Coding agents: route agents through the gateway](https://onecli.sh/docs/guides/coding-agents.md)
* [Claude Code plugin](https://onecli.sh/docs/guides/claude-code-plugin.md)

## Endpoints

| Endpoint | Method and path | What it does |
| - | - | - |
| [List skills](https://onecli.sh/docs/api-reference/skills/list-skills.md) | `GET /skills` | List every skill that reaches a workspace, from the organization, the workspace, and its agents, without the skill bodies. |
| [Create a skill](https://onecli.sh/docs/api-reference/skills/create-a-skill.md) | `POST /skills` | Create a skill for a workspace, or for one hosted agent, so your agents learn a task with reusable instructions. |
| [Get a skill](https://onecli.sh/docs/api-reference/skills/get-a-skill.md) | `GET /skills/{skillId}` | Fetch one skill with its full body and files, including organization skills shared into the workspace. |
| [Update a skill](https://onecli.sh/docs/api-reference/skills/update-a-skill.md) | `PATCH /skills/{skillId}` | Edit a workspace or agent skill's body and files. |
| [Delete a skill](https://onecli.sh/docs/api-reference/skills/delete-a-skill.md) | `DELETE /skills/{skillId}` | Permanently delete a workspace or agent skill so agents in the workspace no longer load it. |

## Next steps

* [API overview](https://onecli.sh/docs/api-reference.md): base URLs, authentication, and pagination
* [Errors](https://onecli.sh/docs/api-reference/errors.md): status codes and the error format
* [Editions](https://onecli.sh/docs/api-reference/editions.md): which endpoints each edition serves


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.