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

# Orion Skills

> Skills teach Orion how your data works. Project skills live in your repository, organisation skills are written or imported in Settings, and the public Datazone skills are loaded for you.

A skill is a short guide that Orion reads when a question needs it. It is a Markdown file with a **name** and a **description** at the top, followed by the instructions:

```markdown theme={null}
---
name: revenue-metrics
description: How revenue and margin are calculated. Use for sales, revenue or margin questions.
---

- Revenue lives in `sales_orders.net_amount`, in TRY.
- Exclude rows where `status = 'CANCELLED'`.
```

Orion sees only the name and the description at first. It reads the full instructions when it decides the skill matches the question. A long list of skills does not crowd every answer this way.

## Which skills each assistant reads

| Skill | Where it comes from | Read by |
| - | - | - |
| Project skills | `skills/<folder>/SKILL.md` in a project repository | [Orion Prime](https://docs.datazone.co/reference/orion/prime.md) |
| Organisation skills | Written or imported in **Settings > AI > Skills** | Orion Prime |
| Public Datazone skills | The `datazone-skills` repository | [Orion Code](https://docs.datazone.co/reference/orion/code.md) |

Orion also has built-in skills that explain how its own tools work. You do not manage those.

## Project skills

To add a project skill, create a folder under `skills/` in the project repository, and put a `SKILL.md` in it. A folder can hold reference files next to it:

```text theme={null}
skills/
  revenue-metrics/
    SKILL.md
    references/
      margin-rules.md
```

* You do not list project skills in `config.yml`. Orion finds every `skills/<folder>/SKILL.md`.
* Only a deploy of the default branch loads them. Edit the skill on a branch, merge it to the default branch, and deploy.
* A skill can have up to 20 reference files, each up to 64 KB. Larger files and binary files are left out.
* A `SKILL.md` that cannot be read is left out, and the rest of the deploy goes ahead.
* The **Skills** tab in the project's drawer lists the project's skills. To change one, edit it in the repository. The settings page shows project skills as read-only.

## Organisation skills

Organisation skills belong to the whole organisation, not to one project. Users with the Orion manage permission (`orion:manage`) create them in **Settings > AI > Skills**.

* **New skill** creates one. Give it a **Name** (letters, digits, `-` and `_`, unique among organisation skills), a **Description**, and the **Instructions** in Markdown.
* Open a skill to **Edit** it, or **Delete** it.
* **Import from URL** creates a skill from a public `https` link to a Markdown file that starts with `name` and `description`. A raw GitHub link to a `SKILL.md` works. Links to private or internal addresses are refused. An imported skill shows the address it came from.

> [!NOTE]
>
> Creating, editing, deleting and importing skills need the `orion:manage` permission. See [Policies](https://docs.datazone.co/reference/development/policy.md).

## Public Datazone skills

Orion Code also loads the public skills that teach AI assistants how to work with Datazone: pipelines, endpoints, flows, Intelligent Apps, Studio Apps, the API, Knowledge Objects, settings and project setup. They are kept in the [datazone-skills](https://github.com/datazoneco/datazone-skills) repository, which is the same collection described on [AI Skills](https://docs.datazone.co/ai-skills.md).

* Orion loads them for you. You do not install or edit them, and they are not listed under **Settings > AI > Skills**.
* Orion refreshes its copy about once an hour. If a refresh fails, it keeps the copy it already has.

> [!NOTE]
>
> An installation with no internet access gets only Orion's own built-in skills. The public skills need the repository to be reachable.

## Related

* [Orion Prime](https://docs.datazone.co/reference/orion/prime.md)
* [Orion Code](https://docs.datazone.co/reference/orion/code.md)
* [AI Skills](https://docs.datazone.co/ai-skills.md)
* [Policies](https://docs.datazone.co/reference/development/policy.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.