Skip to navigation

Read one skill, including its files

View as Markdown

A skill is instructions the agent reads on demand — it never executes, never dispatches and is never approval-gated (actions are the executable, gated layer). Fetches the tier that WINS this slug for the caller tenant (or, with agentId, for that agent) — never a merge across tiers. Authorization: any authenticated org member. 404 skill_not_found when no tier defines it. Response { data: Skill } including files.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

slugstringRequired

Query parameters

agentIdstringOptional>=1 character

Include that agent’s own tier and resolve the slug as that agent would see it.

Response

The winning skill.
dataobject