> ## Documentation Index
> Fetch the complete documentation index at: https://agentheya.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/sidebar-menu/skills)\
**Related:** [Skills guide](/skills)

## 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.             |