Skip to main content
Your organisation’s skills live on the Skills page, reached from the left-hand navigation. It lists everything the AI can draw on, both the skills you have uploaded and the skills you have added from the marketplace, with a count of the total. Two buttons sit in the header:
  • Upload skill: add a skill your team has written
  • Browse marketplace: add a ready-made skill from the Versori catalogue
To find a skill in a long list:
  • Search skills matches on name and summary
  • Status shows only Mandatory or Optional skills
  • All categories filters by category, offering only the categories your own skills use
  • Sort orders the list by Name A-Z, Name Z-A, or Recently updated
Select any skill to open it and read its SKILL.md and resource files.
The Skills page in Versori, listing four skills with Mandatory, Optional, Installed and Forked from marketplace badges

The Skills page lists every skill your organisation has, with its status and where it came from

​
Upload a skill

1

Write the SKILL.md

Create a SKILL.md file with the frontmatter and guidelines you want the AI to follow. Add resource files alongside it if your guidelines reference longer material.
2

Select Upload skill

On the Skills page, select Upload skill, then drop in your skill or use Select file / Select folder. Three shapes work:
  • A .skill or .zip bundle
  • A single SKILL.md
  • A folder with SKILL.md at its root
Resource files may be .md, .txt, .json, .yaml, .csv, .xml, or .html. Anything else is dropped from the upload, and the dialog tells you what it removed.
The index file must be named exactly SKILL.md. A miscased name such as skill.md is rejected, so a bundle is never uploaded without its index.
3

Check the details

Name and the skill body are read from your SKILL.md frontmatter. Fill in the rest as needed:
  • Summary: one or two lines on what the skill does
  • Category: an optional grouping label, used for filtering
  • Product image URL: an optional logo shown against the skill
  • Mandatory: turn on to apply this skill to every request. Leave it off unless you have a reason, and see How the AI applies skills first. You can change it later from the skill’s card.
4

Select Save skill

The skill appears in your organisation’s list, ready for the AI to use.
Uploads are checked for content that would try to hijack the AI’s instructions, and an upload that fails the check is rejected. If the check cannot run, the upload is refused rather than allowed through, so try again shortly. Each file must be under roughly 200 KB, and a whole bundle under roughly 2 MB.
Skill names are unique within your organisation. Uploading a skill whose name is already taken is rejected as a conflict. To change a skill you already have, edit it rather than re-uploading.
The Upload skill dialog, showing the drop zone and the Name, Summary, Category and Product image URL fields with the Mandatory toggle

The Upload skill dialog. Name and Summary are read from your SKILL.md frontmatter

​
Edit a skill

Open a skill you own and edit its SKILL.md or any resource file, then save. Each save records a new version, and the AI picks up your change on its next request. Skills added from the marketplace are read-only, because Versori maintains them. To change one, fork it first. See Fork a skill to customise it.

​
Mandatory and optional skills

Every skill carries a Mandatory or Optional badge, which decides how it reaches the AI. Optional is the default: the AI reads the skill only when its description matches the work in hand. Mandatory puts the whole skill into every request. See How the AI applies skills for which to choose. Switch a skill between the two from its card, using Make mandatory or Make optional. The change applies to your whole organisation and takes effect on the AI’s next request.
Making a skill mandatory is a quick way to test whether the AI is missing it. If the results change once the skill is always in context, the skill was relevant but its description was not specific enough for the AI to find it. Sharpening the description is usually better than leaving it mandatory.

​
Remove a skill

Each skill’s card carries the removal action. What it does depends on where the skill came from: The confirmation dialog names the skill and which of the two is about to happen, so check it before confirming.
A confirmation dialog reading Uninstall avalara-certification-connector-builder, with Cancel and Uninstall buttons

Removing a skill you added from the marketplace uninstalls it, leaving the catalogue untouched

  • Skills: what a skill is and how the AI applies it
  • Skills Marketplace: add ready-made skills from the Versori catalogue