Push and pull Skill artifacts

更新时间:
复制 MD 格式

ACR Enterprise Edition lets you package Skills as OCI-compliant artifacts and leverage version management, access control, global synchronization, and security audit to securely distribute and 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

application/vnd.agent.skill.v1+json

Layer Media Type

application/vnd.agent.skill.content.v1.tar+gzip

Config Media Type

application/vnd.oci.empty.v1+json

The manifest of a Skill artifact should include the following custom annotations:

Annotation key

Required/optional

Description

org.agent.skill.name

Required

Skill name

org.agent.skill.version

Required

Skill version

org.agent.skill.description

Optional

Skill description

org.agent.skill.license

Optional

License information

org.agent.skill.author

Optional

Author information

org.agent.skill.compatibility

Optional

Compatible environment list (JSON array format)

org.opencontainers.image.created

Required

Creation timestamp (RFC 3339 format)

org.opencontainers.image.source

Optional

Source code repository URL

Tool and Agent usage

The following methods are available for managing Skill artifacts on ACR Enterprise Edition instances:

Method

Description

Scenarios

Use acr-skill tool

A dedicated command-line tool for managing the entire Skill lifecycle.

Best when you need full lifecycle features: publishing, installing, updating, listing, and validating Skills.

Use ORAS tool

An open-source command-line tool for managing OCI artifacts. It supports pushing and pulling any type of OCI artifact.

Best when you need only basic push and pull operations.

Use Agent

Installs the acr-skill tool as a Skill in the Agent environment, enabling automatic invocation through conversation.

Best when you want to automate Skill management through Agent conversations.