Skip to content

GET /:clientId/skills/*skillPath

Reads one exact skill node over the nested HTTP route.

Request

Path parameters:

  • clientId
  • skillPath

Query parameters and headers are forwarded to the skill resolver in the same way as the direct route.

Example:

http
GET /client-01/skills/docs/root/child?a=1

Response

Status 200 OK with UTF-8 text payload:

md
# Child Skill

The response Content-Type follows the skill descriptor content type. For Markdown skills that means text/markdown; charset=utf-8.

If the resolved skill returns non-string data, the server responds with:

json
{
  "data": {}
}

Error cases

StatusShapeWhen it happens
400{ "error": string }Invalid skill request
404empty bodySkill descriptor not found
405empty bodyMethod is not GET or OPTIONS
502{ "error": unknown }Skill invocation failed on the target client

Notes

Model Drive Protocol