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

# Update or retire a skill you created

> Upload a revised version of a skill your space authored, or retire that skill. Acquiring someone else's skill does not give you these rights.

Publish a revised version of a skill your space authored, or retire it when you no longer want to offer it. Acquiring another creator's skill does not give your space the right to replace or retire their original.

Choose the change that matches your goal:

| Your goal | Use |
| - | - |
| Improve your skill's guidance while keeping the same skill | [Upload a revised version](#upload-a-revised-version). |
| Stop one agent using a skill | **Disable on this agent** or **Remove from agent**. See [Review a skill before adding it](https://docs.alysium.ai/build-your-agent/review-a-skill-before-adding-it.md). |
| Stop offering your authored skill | [Retire the skill](#retire-the-skill). |

If you have not opened the skill yet, start with [Open your authored skill](#open-your-authored-skill).

**Already reading your authored skill's details?** Continue with [Upload a revised version](#upload-a-revised-version) or [Retire the skill](#retire-the-skill).

## Open your authored skill

1. Open [Home](https://app.alysium.ai/spaces).
2. Select the intended agent.
3. Open **Build**.
4. Open **Settings**.
5. Find **Skills**.
6. Select the skill's name.
7. Read its current **Version** and contents.
8. Continue with [Upload a revised version](#upload-a-revised-version) or [Retire the skill](#retire-the-skill).

Home opens your active space, where you choose the agent. If it asks you to sign in, sign in. Open Home again if needed.

A skill authored by your space can offer **Update** and **More actions** in its details. If those controls are missing, check whether you are looking at your own skill or one acquired from another creator.

## Upload a revised version

Prepare the revision in the actual skill bundle you authored. Keep its skill name the same: a bundle with a different name is not a supported rename update. Keep the previous bundle yourself if you need a record. [Upload your own skill](https://docs.alysium.ai/build-your-agent/upload-your-own-skill.md) lists the package formats and limits.

For example, you might revise a customer-answer skill to ask for missing context before proposing an answer. This is an edit to your guidance, rather than an automatic change made by Alysium.

Ordinary attachments to your space's authored skill follow its current version. Updating the skill can therefore change the guidance used by those agents.

1. In the skill's details, select **Update**.
2. Select the revised bundle.
3. Wait for checking and upload.
4. Reopen the skill's details.
5. Review the resulting version and contents.
6. Try a relevant task with an affected agent.

Selecting and uploading the bundle applies the update. There is no separate Design **Save Changes** step. If the bundle name does not match, correct the prepared bundle before submitting it again.

### An acquired skill's Update is different

Skills acquired from other creators normally stay on the version accepted when attached. A list-row **Update** offered for an older acquired version moves that agent's attachment to the latest version.

Read the changes before accepting another creator's new version. This list action updates an attachment; it does not upload a replacement to the creator's original skill.

## Retire the skill

Retirement removes your authored skill from your library and new discovery. People who already acquired it keep access. Retirement does not take their copies back.

There is no undo control. Uploading the same name afterward creates a fresh skill instead of restoring the retired one. If you only want to compare one agent without the guidance, disable its attachment instead.

1. In the skill's details, open **More actions**.
2. Select **Delete skill**.
3. Read the confirmation.
4. Select **Delete skill** again if you intend to retire it.
5. Check your space's agents for remaining attachments to the skill.
6. For each remaining attachment, select **Remove from agent**.

An incomplete attachment-removal step does not necessarily undo retirement. If a retirement or update message is unclear, check the skill's actual current state before repeating the action.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.