Skip to content
Latest (currently 2026.8.0) has the newest features, bug fixes, and CVE patches of Solo Enterprise for agentregistry.

For the complete documentation index, see llms.txt. Markdown versions of all docs pages are available by appending .md to any docs URL.

Create and publish

Page as Markdown

Quickly create an agent skill and publish it to the registry catalog with built-in skill templates.

A skill is a reusable instruction set or slash command for AI agents that you can store as a versioned artifact in the catalog. Instead of sharing skill files ad-hoc, developers publish skills to the registry with a version tag. When the author iterates on a skill, they publish a new version to the catalog so that consumers can pull the update at any time rather than waiting to receive a file over email or Slack.

Before you begin

  1. Set up an OIDC provider so that users can authenticate with the registry.

  2. Install Solo Enterprise for agentregistry and the arctl CLI.

  3. Port-forward the Solo Enterprise for agentregistry server on port 12121 if you have not done so already. The registry is not exposed externally by default, so you need port-forwarding to reach it from your local machine.

    kubectl -n agentregistry-system port-forward svc/agentregistry-enterprise-server 12121:12121

Create the skill

  1. Create a scaffold for a myskill Claude skill. The following command creates a myskill directory that includes a hello-world.py script that generates a greeting output based on the input parameters that you provide.

    arctl init skill myskill
  2. Explore the skill scaffold that was created for you. You can optionally make changes to the files to customize your skill further.

    ls myskill

    Example output:

    assets    LICENSE.txt   references  scripts     SKILL.md    skill.yaml
    
    FileDescription
    assetsDirectory containing static assets such as images, files, or other resources used by the skill.
    LICENSE.txtLicense file containing the license information for your skill.
    referencesDirectory containing reference documentation, links, or additional resources related to the skill.
    scriptsDirectory containing helper scripts for building, testing, or running the skill.
    SKILL.mdThe skill definition file with YAML frontmatter that describes the skill, its capabilities, and metadata. This file is required for publishing the skill to agentregistry.
    skill.yamlThe Solo Enterprise for agentregistry definition for the skill resource. This file includes information about the Docker container image and GitHub repository location where the skill source code is stored. You need the skill resource to add a skill to the Solo Enterprise for agentregistry catalog.
  3. Review the skill.yaml skill resource.

    cat myskill/skill.yaml

    Example output:

    apiVersion: ar.dev/v1alpha1
    kind: Skill
    metadata:
      name: myskill
    spec:
      title: myskill
      description: myskill skill
    

Publish the skill

  1. Publish the skill in the registry catalog.

    arctl apply -f myskill/skill.yaml
  2. Verify that the skill is created.

    arctl get skills

    Example output:

    NAME      TAG      DESCRIPTION
    myskill   latest   myskill skill
    
  3. Optional: Open the agentregistry UI and go to the Catalog > Skills view. Verify that you can see your skill.