Skip to main content
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:
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

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:
  • 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.
Creating, editing, deleting and importing skills need the orion:manage permission. See Policies.

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 repository, which is the same collection described on AI Skills.
  • 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.
An installation with no internet access gets only Orion’s own built-in skills. The public skills need the repository to be reachable.