GET /skills/:clientId/*skillPath
Reads one exact skill node over the direct HTTP route.
Request
Path parameters:
clientIdskillPath
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=mdpResponse
Status 200 OK with UTF-8 text payload:
md
# Child SkillThe 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
| Status | Shape | When it happens |
|---|---|---|
400 | { "error": string } | Invalid skill request |
404 | empty body | Skill descriptor not found |
405 | empty body | Method is not GET or OPTIONS |
502 | { "error": unknown } | Skill invocation failed on the target client |
Notes
OPTIONSreturns204.- On
405, the response includesAllow: GET, OPTIONS.