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 underskills/ 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 everyskills/<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.mdthat 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
httpslink to a Markdown file that starts withnameanddescription. A raw GitHub link to aSKILL.mdworks. 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.