AI Registry Skill Management-Microservices Engine(MSE)-阿里云帮助中心

Use AI Registry to create, version, publish, and download Skills — reusable AI capability units for your applications.

Prerequisites

You have an Alibaba Cloud account and have activated the AI Registry service.
You have created at least one workspace. If you have not created one yet, refer to AI Registry Workspace Management Guide.
Your account has the required permissions for Skill operations. To grant permissions to a RAM sub-account, refer to Configure RAM Permissions for AI Registry.

Core Concepts

Concept	Description
Skill	An AI capability unit consisting of a SKILL.md descriptor file and optional resource files.
Version	A snapshot of Skill content that follows semantic versioning (for example, 0.0.1, 0.0.2).
Draft	An editable state before a version is published. Changes to a draft do not affect already-published content.
Version Label	A semantic alias for a version, such as `latest`. Consumers reference the Skill by label rather than by a specific version number.
Visibility (Scope)	Controls whether the Skill is visible to other users: Public (visible to everyone) or Private (visible only to yourself and specified users).
Business Tags (BizTags)	Tags used for business classification and search.
Enable/Disable	Skill-level service state control. When a Skill is disabled, all its versions stop providing service.

Skill Lifecycle

Version publishing workflow:

Create/Import → Edit Draft → Submit for Review (security scan) → Publish Version
    ↑                                       ↓
    └──────────── New version iteration ←───┘

Independent operations:

Enable/Disable (Skill level): Controls whether the Skill as a whole provides service. Does not affect the version publishing workflow.
Online/Offline (version level): Controls whether a single published version is available externally.

Navigate to the Skill Management Page

Log on to the Alibaba Cloud console and go to the Microservices Engine MSE product page.
In the left navigation pane, click AIRegistry to enter the AI Registry.
Under AI Resource Management in the left navigation pane, click Skill to go to the Skill management page.
Select the target workspace from the Workspace drop-down list at the top of the page to view the Skill list for that workspace.

Note

If no workspace is available, go to the Workspace page in the left navigation pane and click Create Workspace to create one first, then return to the Skill management page and select the workspace.

Operations Guide

Permission Notes

Only the Skill Owner can perform write operations such as editing, publishing, deleting, and taking online or offline.
For non-Owner users, write operation buttons on the detail page are disabled.
PRIVATE Skills are visible in the list only to their Owner.

Skill List Page

Lists all Skills in the current workspace. Search by name, filter by visibility, or sort by download count.

Browse Skills

The Skill Management page displays all Skills in the current workspace. Each Skill card shows:

Name, description, and visibility (Public/Private)
Latest published version number, download count, and online usage count
Business tags and author
Enable status

Click a card to open the Skill detail page.

Search and Filter

Search: Enter a keyword in the top search box to fuzzy-match by Skill name.
Filter by visibility: All / Public only / Private only
Sort: Default order (by last modified time) or by download count

Create Entry Points

Two entry points are available in the upper-right corner of the list page:

Import Skill: Import an existing Skill by uploading a file or using the CLI.
New Skill: Manually create a new Skill.

Create and Import Skills

Create a Skill manually in the console or import an existing local Skill folder by using the Nacos CLI.

Create a New Skill

On the Skill list page, click + New Skill in the upper-right corner to go to the manual creation page.

Procedure:

Fill in the basic information:
- Skill Name (required): Up to 64 characters, used to identify the Skill.
- Description (required): Up to 1000 characters describing the Skill's function and purpose.
- Tags: Enter a tag and press Enter to confirm. Used for business classification and search.
Expand Advanced Options to set visibility:
- Private (default): Visible only to yourself and specified users.
- Public: Visible to everyone.
Write the SKILL.md content (required): Use Markdown format to describe the Skill in detail. The editor provides a code editing panel on the left and a real-time preview on the right.
Click Create Now in the upper-right corner to finish.

After successful creation, the system generates an initial draft version, which appears in the Skill list.

Import a Skill

On the Skill list page, click Import Skill. Two import methods are supported:

Method 1: Upload a File

Select a local Skill ZIP package and upload it directly. Suitable for Skills that have been developed locally.

Method 2: Nacos CLI

Use the command-line tool to import a local Skill folder. Suitable for developers' daily workflow.

Procedure:

For first-time use, configure login credentials. For more information, refer to Connect Nacos CLI to AI Registry:

npx @nacos-group/cli profile edit

Import the local Skill folder using the command line:

npx @nacos-group/cli skill-publish xxx-skill

Skill Version and Draft Management

Manage Skill versions through their full lifecycle: create drafts, edit content, submit for review, publish, assign labels, and take versions offline.

Version Status

Status	Description
Draft	Editable; supports modifications to SKILL.md and resource files.
Pending Publish	Has passed security review; awaiting manual publishing.
Published	Official version providing service externally; content cannot be modified.

Create a Draft

On the detail page, select the version you want to base the draft on, then click Create Draft Based on This Version:

Enter the new version number (auto-incremented by the system; you can modify it manually).
Click Save as Draft.

Note

A draft is created based on an existing version. You must complete the publishing workflow manually for it to take effect.

Edit a Draft

Select the draft version and click Edit Draft to enter the editing page:

SKILL.md tab: Markdown editor with real-time preview for writing Skill descriptions and usage instructions.
File Directory tab: Manage accompanying resource files.
Change Notes: Record the changes made in this edit.

Click Save when editing is complete. Saving does not automatically publish the draft.

Delete a Draft

Select the draft version and click Delete Draft. Confirm to delete. Published versions are not affected.

Submit for Review

Prerequisite: To perform a security scan on Skill content, you must first enable the Alibaba Cloud Security Fence. For details, refer to Activate pay-as-you-go for Guardrails.

When the draft is ready, click Submit for Review. The system automatically performs a content security scan:

Prompt injection detection: Checks for malicious prompt injections.
Content compliance detection: Checks for content security compliance.

Click View Results to see the scan details for each file. After the review passes, the version enters the Pending Publish state.

Publish a Version

After the review passes, click Publish Version. The version takes effect and begins serving externally after confirmation.

Version Labels

Select a published version, then click Edit in the Version Labels area to bind a semantic label to the version (for example, latest).

Consumers reference the Skill by label. When you release an update, point the label to the new version — consumers pick up the change automatically.

Take a Version Offline

Select a published version and click Take Offline to remove that version from service. Other versions are not affected.

To stop all versions from providing service, use Disable Skill.

Download and Use Skills

Download a Skill for local use from the console or by using the NPX CLI tool (supports QwenPaw, Qoder, Claude, Cursor, and other CLIs).

Manual Download

On the Skill detail page, in the Usage Guide area on the right, click Download .zip File to download the complete Skill package for the current version.

Suitable for local review, backup, or migration to another environment.

Download via CLI

On the detail page, in the NPX Download area on the right, select the corresponding CLI tool and follow the steps:

Supported CLI tools: QwenPaw, OpenClaw, Qoder, QoderWork, Claude, Codex, Cursor, Kiro, Lingma

Steps:

For first-time use, configure login credentials. For more information, refer to Connect Nacos CLI to AI Registry:

npx @nacos-group/cli profile edit

Download the Skill to local storage:

npx @nacos-group/cli skill-get <skill-name> --version <version> -o <output-path>

Different CLI tools have their own default Skill storage paths. The page automatically generates the corresponding command based on your selection.

Skill Details and Settings

View version content and Skill information, and manage settings such as visibility, enable status, business tags, and deletion.

View Details

On the detail page, you can view and manage:

Version content: Use the version drop-down in the upper-left corner to switch between versions and view SKILL.md content and resource files.
Version labels and change notes: Labels bound to the current version and publish notes.
Skill information (right panel): Visibility, enable status, author, business tags, and description.
Usage Guide (right panel): Download methods and CLI commands.

Modify Visibility

Toggle the visibility switch in the Skill information area on the right:

Private: Visible only to yourself and specified users.
Public: Visible to everyone.

A confirmation prompt appears. The change takes effect after you confirm.

Enable and Disable

Toggle the enable status in the Skill information area on the right:

Disable: All versions stop providing service externally.
Enable: Restores external service.

Disabling is a Skill-level operation that affects all versions. To control a single version only, use Take Version Offline.

Edit Business Tags

In the Skill information area on the right, click Edit next to Business Tags, enter a tag, and press Enter to add it. Multiple tags are supported.

Delete a Skill

Click Delete Skill in the upper-right corner. After confirmation, the Skill and all its versions are permanently deleted. This operation cannot be undone.

Common Scenarios

Scenario 1: Create and Publish a Skill for the First Time

On the list page, click + New Skill, fill in the name, description, and tags, write the SKILL.md content, and click Create Now.
Go to the detail page and confirm the content is correct.
Click Submit for Review. The system automatically performs a content security scan.
After the scan passes, click Publish Version.
Enable the Skill, switch visibility to Public as needed, and add business tags.

Scenario 2: Iterate a Version

On the detail page, select the currently published version and click Create Draft Based on This Version.
Click Edit Draft, modify SKILL.md or resource files, and save.
Click Submit for Review and wait for the security scan to pass.
Click Publish Version.
Edit the version label to point latest to the new version.
After confirming the new version is working correctly, take the old version offline.

Scenario 3: Import an Existing Skill via CLI

Configure CLI login credentials: npx @nacos-group/cli profile edit
Import the local Skill folder: npx @nacos-group/cli skill-publish <skill-folder>
Confirm that the Skill has been created in the console list.
Go to the detail page to complete the review and publishing workflow.

Scenario 4: Download a Skill for Local Use

Go to the target Skill detail page.
Select a download method:
- Manual download: Click Download .zip File.
- NPX download: Run npx @nacos-group/cli skill-get <name> --version <ver> -o <path>
After the download completes, you can use the Skill in your local CLI tool.

Scenario 5: Emergency Skill Takedown

If you need to stop a Skill from serving immediately:

Stop a single version: On the detail page, select the target version and click Take Version Offline.
Stop the entire Skill: In the Skill information area on the right, switch the status to Disabled. All versions immediately stop providing service.

To restore service, perform the reverse operation.

Scenario 6: Clean Up Unused Skills

Disable the Skill and observe for a period to confirm there is no impact.
On the detail page, click Delete Skill to permanently delete it.

Deletion is irreversible. Disable the Skill and observe for a period before deleting.