skills

Reusable instruction packs (with optional scripts, references, and assets) the agent can invoke for specialised procedures.

skills — Skills

Reusable instruction packs (with optional scripts, references, and assets) the agent can invoke for specialised procedures.

Section key skills · Shape object · Tier All plans
Edit in the dashboard: Skills page
Related: Skills guide

Fields

Field	Required	Type	Allowed values / constraints	Default	Description
skills	no	array of object	—	—	List of skill metadata entries. Full skill content (code, references, assets) lives on the filesystem. Item fields below.

skills items

List of skill metadata entries. Full skill content (code, references, assets) lives on the filesystem.

Field	Required	Type	Allowed values / constraints	Default	Description
name	yes	string	—	—	Skill name (identifier). Letters, digits, underscores; starts with a letter.
description	yes	string	—	—	Short description shown to the agent when choosing which skill to invoke.
action	no	string	—	—	Markdown instructions the agent reads when the skill is invoked (analogous to ‘instructions’ in other contexts).
enabled	no	boolean	—	—	When false, the skill is registered but unavailable at chat time.
collapsed	no	boolean	—	—	UI hint — start this entry collapsed in the dashboard.
scripts	no	array of object	—	—	Code files for this skill. Stored on disk in the skill’s scripts/ subdirectory. Item fields below.
references	no	array of object	—	—	Reference files attached to this skill (PDFs, docs, etc.). Item fields below.
assets	no	array of object	—	—	Asset files attached to this skill (images, templates, etc.). Item fields below.

skills.scripts items

Code files for this skill. Stored on disk in the skill’s scripts/ subdirectory.

Field	Required	Type	Allowed values / constraints	Default	Description
name	no	string	—	—	Identifier for this script file (without extension). Used in the generated tool name and as the filename on disk. Letters, numbers, hyphens, underscores only.
code	no	string	—	—	Source code of the script (Python or JavaScript). The agent executes this at runtime with optional args and stdin. Language is auto-detected from syntax or inferred from a stored language hint.

skills.references items

Reference files attached to this skill (PDFs, docs, etc.).

Field	Required	Type	Allowed values / constraints	Default	Description
name	no	string	—	—	Original filename of the reference document (PDF, markdown, CSV, etc.). The agent can read this file at runtime via the read_skill_file tool.
size	no	string	—	—	Human-readable file size (e.g. ‘1.2 MB’). Calculated when the file is read from disk; used for display in the dashboard.
path	no	string	—	—	Relative path to the file within the skill directory (e.g. ‘references/guide.pdf’). Used by the runtime to locate and serve the file.

skills.assets items

Asset files attached to this skill (images, templates, etc.).

Field	Required	Type	Allowed values / constraints	Default	Description
name	no	string	—	—	Original filename of the asset file (image, template, config, etc.). The agent can read this file at runtime via the read_skill_file tool.
size	no	string	—	—	Human-readable file size (e.g. ‘512 KB’). Calculated when the file is read from disk; used for display in the dashboard.
path	no	string	—	—	Relative path to the file within the skill directory (e.g. ‘assets/logo.png’). Used by the runtime to locate and serve the file.