Container Registry (ACR) Enterprise Edition instances support hosting and distributing various types of cloud-native artifacts as OCI artifacts. By packaging Skills as OCI-compliant artifacts, you can use features of ACR Enterprise Edition, such as version management, access control, global synchronization, and security audit, to securely distribute and centrally manage Skills across your organization.
Skill artifact format
When you push and pull Skill artifacts, use the following media types (compatible with both the acr-skill tool and the ORAS tool):
Type | Media type |
Artifact Type |
|
Layer Media Type |
|
Config Media Type |
|
The manifest of a Skill artifact should include the following custom annotations:
Annotation key | Required/optional | Description |
| Required | Skill name |
| Required | Skill version |
| Optional | Skill description |
| Optional | License information |
| Optional | Author information |
| Optional | Compatible environment list (JSON array format) |
| Required | Creation timestamp (RFC 3339 format) |
| Optional | Source code repository URL |
Tool and Agent usage
You can use the following methods to manage Skill artifacts with the capabilities of ACR Enterprise Edition instances:
Method | Description | Scenarios |
A dedicated command-line tool for managing the entire Skill lifecycle. | Ideal for scenarios that require a full range of features, such as publishing, installing, updating, listing, and validating Skills. | |
An open-source command-line tool for managing OCI artifacts. It supports pushing and pulling any type of OCI artifact. | Ideal for scenarios that require only basic push and pull operations. | |
Installs the acr-skill tool as a Skill in the Agent environment, enabling automatic invocation through conversation. | For scenarios where you want to automate Skill management within Agent conversations. |