> ## Documentation Index
> Fetch the complete documentation index at: https://docs.relayhub.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Evolving Skills

> Improve a skill by describing the change you want

Evolve is how skills get better over time without anyone editing code. You describe a change in plain language ("Always include the customer ID in the output", "Make the summary longer"), review a diff of what will change, try the new version safely, and apply it. Every evolution creates a new version, and reverting is one click.

Start an evolution from the **Evolve** button on a skill, or directly from chat when you tell the AI a skill's output needs adjusting.

## The Evolve Wizard

<Steps>
  <Step title="Describe the change">
    Write what should be different about the skill. If you arrived from chat, your feedback is pre-filled.
  </Step>

  <Step title="Review the diff">
    A side-by-side diff shows exactly what will change in each of the skill's files. Validation warnings, if any, appear in a banner; they do not block you.
  </Step>

  <Step title="Try it">
    Click **Try It** to run the proposed version in a sandbox without saving anything. You see the live output and can go back and revise the change if it is not right.
  </Step>

  <Step title="Apply">
    Click **Apply**. The skill gets a new version (for example v2 to v3) and the change is live immediately. The previous version stays in history.
  </Step>
</Steps>

## Guard Rails

* **Versioned and reversible**: every applied evolution is a new version. Use the skill's Versions tab to revert.
* **Scoped changes**: the AI changes only what you asked for. It will not rename the skill or add new credentials unless you explicitly request it.
* **Bundled skills fork automatically**: evolving a bundled skill creates a personal copy that you own; the original bundled skill is untouched for everyone else.
* **Ownership**: the skill's author applies evolutions directly. Changes proposed by other users queue as proposals for the author to review, and workspace admins can require this review for all changes.

<Tip>
  Evolve from chat in the moment. When a skill's report comes back and a column is missing, say so right there: the AI offers to evolve the skill with your feedback pre-filled.
</Tip>