Skip to content

Skills

Get a platform/system skill by slug, including full instructions.

Returns:

  • slug, name, description — identity fields
  • version — active revision number
  • tool_slugs — MCP tool names the skill uses
  • agent_only_tool_slugs — tools the skill uses that this surface does not expose (see below)
  • instructions — the full step-by-step procedure to follow
  • reference_material — optional supplementary reference text

Reading instructions tells you exactly how to carry out the skill. Every tool in tool_slugs is exposed by the agents, building_blocks, chats, schedules and integrations MCP modules — call them as directed.

instructions is written for a running agent, so its prose names tools in the agent-runtime vocabulary. Two things follow. Some names are spelled differently here (e.g. the prose says create_custom_tool; the MCP tool is create_code_tool) — tool_slugs already gives you the MCP spelling, in the same order. And the steps using a tool listed in agent_only_tool_slugs cannot be carried out from an MCP client at all: integration discovery/connect, self-modification and memory are agent-run concerns. Do the rest of the procedure and say plainly which steps you skipped.

Raises a ToolError if the slug does not match any active system skill. Use list_system_skills to see available slugs.

ParameterTypeRequiredDescription
slugstringyes

List all active platform/system skills available on this deployment.

System skills are global — they are not scoped to any org and are the same for every authenticated user. Each entry contains:

  • slug — stable identifier, use with get_system_skill
  • description — one-line summary
  • version — current active revision number
  • tool_slugs — MCP tool names the skill relies on, callable here
  • agent_only_tool_slugs — steps of this skill that only a running agent can perform; there is no MCP tool for these

Call get_system_skill(slug) to retrieve the full instructions for a specific skill before executing it.

No parameters.