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

This topic describes the Skill management feature of AI Registry (AI Governance Center), including Skill creation, version management, publishing, and downloading.

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 Governance Center Workspace Management Guide.
Your account has the required permissions for Skill operations. To grant permissions to a RAM sub-account, refer to AI Registry RAM permission configuration.

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 Governance Center.
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

View all Skills in the current workspace. You can search by name, filter by visibility, and sort by download count. Each Skill card shows key information such as name, version, download count, and online count.

Browse Skills

After entering the Skill Management page, all Skills in the current workspace are displayed. 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

You can manually create a Skill in the console by filling in the name, description, tags, and visibility, and writing the SKILL.md content. You can also import an existing local Skill folder 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 automatically generates an initial version in draft state, 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 Access AI Registry with Nacos CLI:

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 the complete lifecycle of Skill versions: create drafts, edit SKILL.md and resource files, submit for review (content security scan), publish versions, manage version labels, and take old 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. After confirmation, the version takes effect officially and provides service externally.

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 a version is updated, you only need to point the label to the new version, which is transparent to consumers.

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 by manually downloading the ZIP file 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 Access AI Registry with Nacos CLI:

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

On the Skill detail page, view version content and Skill information, and perform settings operations such as modifying visibility, enabling/disabling, editing business tags, and deleting the Skill.

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 when toggling. The change takes effect after confirmation.

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

When a Skill issue is discovered and you need to stop service 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. It is recommended to disable and observe before deleting.