Publishing

Publish skills to OpenSkill

Prerequisites

• A validated skill (run osk validate)
• An OpenSkill account (sign up at openskill.dev)
• The OpenSkill CLI authenticated (osk login)

Authenticate

Before publishing, log in to the marketplace:

$ osk login

This opens a browser to complete authentication. Once logged in, your token is stored locally and used for all publish operations.

Publishing Workflow

There are two ways to publish skills: via a Git repository or directly to OpenSkill.

Via Git Repository

Create a Git repository with the standard skill repository structure:

my-skills-repo/
├── README.md
├── manifest.json       # Optional metadata
└── skills/
    ├── code-review/
    │   └── SKILL.md
    └── testing-helper/
        └── SKILL.md

Push to a Git hosting service and share the URL:

$ git push origin main

Via OpenSkill

Publishing directly to OpenSkill is a two-step process: push (creates a draft) then publish (makes it public).

Step 1: Audit (recommended)

Run a security audit before pushing to catch potential issues:

$ osk audit ./my-skill

Step 2: Push as draft

Push your skill to the marketplace. This uploads the skill and creates it as a draft:

$ osk push ./my-skill

Step 3: Publish

Once you're ready, make the draft public:

$ osk publish my-skill

Skill Listing

When published, your skill's frontmatter is used to generate the listing page. Make sure your name, description, and tags are well-written for discoverability.

Updating Skills

To publish an update, increment the version field in your frontmatter and push again:

# Update version in SKILL.md, then:
$ osk push ./my-skill
$ osk publish my-skill