Read a File from a Skill

Returns the contents of a single file inside a skill. Use this to render a SKILL.md viewer, show an image, or let a user download a reference file.

The response is discriminated by encoding:

encoding: utf-8 — the file is text and content is the raw UTF-8 string.
Use this branch for .md, .py, .json, etc.

encoding: base64 — the file is binary and content is base64-encoded.
Decode it in your client to recover the original bytes.

Auth: Requires an Authorization token.

Path Parameters

skill_id: The Ejento id of the skill to read from.

file_path: File path relative to the skill root. Supports nested paths like references/notes.md.

Request Body

(none)

Returns

200 OK with { file_path, content, encoding, content_type, size }.

Common Errors

404 file_not_found — the file doesn't exist in this skill.

404 skill_not_found — no skill with this id exists.

400 — the file_path contains unsafe segments (.., absolute paths, etc.).

Current Version 2.0.0

{ "data": { "content": "---\nname: my-skill\ndescription: ...\n---\n\n# My Skill\n", "content_type": "text/markdown", "encoding": "utf-8", "file_path": "SKILL.md", "size": 128 }, "message": "OK", "success": true }

Read a File from a Skill

Request

Responses