Skills API Reference
The Skills API lets you manage skills and agent-skill assignments programmatically. Skills are domain expertise packages that give agents specialized capabilities.
What the Skills API Does
- List and search available skills by category
- View skill details and assigned agents
- Assign and unassign skills to/from agents
- Toggle skill assignments on/off without removing them
- Discover the full skill catalog (including unassigned skills)
- Request skill assignments (creates HITL approval tasks)
Permissions
| Permission | Required For |
|---|---|
skills:read | List, get, search skills |
skills:write | Assign, unassign, update assignments |
Agent MCP Tools for Skills
Agents interact with skills through four MCP tools during conversations:
| Tool | Purpose |
|---|---|
| skill_query | Load instructions from an assigned skill for domain expertise |
| skill_discover | Browse the full skill catalog to find new skills |
| skill_request | Request assignment of a skill (creates HITL approval task) |
| connector_discover | Discover connected and available integrations with skill recommendations |
See also: Skills Overview | Skills Architecture