> ## Documentation Index
> Fetch the complete documentation index at: https://docs.versori.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Manage Your Skills
> Upload your own skills to your Versori organisation, then edit them, set whether they always apply, and remove them.
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](/latest/ai-tooling/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.
## Upload a skill
Create a `SKILL.md` file with the [frontmatter and guidelines](/latest/ai-tooling/skills#the-skillmd-file)
you want the AI to follow. Add resource files alongside it if your guidelines reference longer material.
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.
**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](/latest/ai-tooling/skills#how-the-ai-applies-skills) first. You can
change it later from the skill's card.
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.
## 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](/latest/ai-tooling/marketplace#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](/latest/ai-tooling/skills#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:
| Skill | Action | Effect |
| -------------------------- | ------------- | -------------------------------------------------------------------- |
| Uploaded or forked by you | **Delete** | Removes the skill and its edits. This cannot be undone. |
| Added from the marketplace | **Uninstall** | Removes it from your organisation. You can add it again at any time. |
The confirmation dialog names the skill and which of the two is about to happen, so check it before confirming.
## Related docs
* [Skills](/latest/ai-tooling/skills): what a skill is and how the AI applies it
* [Skills Marketplace](/latest/ai-tooling/marketplace): add ready-made skills from the Versori catalogue