Skip to content

GET /skills/:clientId/*skillPath

Reads one exact skill node over the direct HTTP route.

Request

Path parameters:

  • clientId
  • skillPath

Query parameters:

  • forwarded to the skill resolver as args.query

Headers:

  • forwarded to the skill resolver as args.headers

Example:

http
GET /skills/client-01/docs/root/child?topic=mdp

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:

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

  • OPTIONS returns 204.
  • On 405, the response includes Allow: GET, OPTIONS.

Model Drive Protocol