> For the complete documentation index, see [llms.txt](https://docs.dextoros.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dextoros.app/skills-and-training/skill-versions.md).

# Skill versions

How skills are versioned, and how a new version reaches the fleet.

{% hint style="warning" %}
**Draft.** Some details on this page are still being confirmed and may change. Questions? Email <info@dextoros.app>.
{% endhint %}

Every skill has a version number, such as **Pick and place v4**. A new version is created each time the skill is taught again or a training run finishes.

## Where versions come from

| Source                                     | Result                                                                                                             |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------ |
| A new demonstration with **Hold to teach** | The skill moves to the next version, for example v4 to **Taught v5**.                                              |
| A finished training session                | A new version is trained, evaluated and published, for example `Published pick and place v5 back to all 4 robots`. |

## How a version reaches robots

1. DextorOS checks the fleet for robots that have every capability the skill needs.
2. Each capable robot learns the new version. Its status changes to, for example, **v5 learned**, and the fleet shows how many robots learned it, such as **Learned by 3 of 6 robots**.
3. Robots missing a capability don't receive it, and their status shows what they need, for example **Needs arm and gripper**.

## Training and evaluation

Before a trained version is published, it's tested on held-out episodes that weren't used for training. The result shows how often the new version succeeds compared with the one in use.

After publishing, every robot in the session switches to the new version, shown as **v5 in use**.

## Related

* [Teach a skill](/skills-and-training/teach-a-skill.md)
* [Which robots can run a skill](/skills-and-training/which-robots-can-run-a-skill.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.dextoros.app/skills-and-training/skill-versions.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.