Commands

Complete CLI command reference

All commands follow the pattern osk <command> [options]. Use osk --help or osk man <command> for detailed help.

install

Install skills from a repository URL or by name.

$ osk install <source> [skill] [options]

# Install from GitHub URL
$ osk install https://github.com/user/skills

# Install specific skill by name
$ osk install code-review

# Install for a specific agent
$ osk install code-review -t claude

# Install globally
$ osk install code-review -g

uninstall

Remove an installed skill.

$ osk uninstall <skill> [options]

$ osk rm code-review

list

List installed skills, optionally filtered by name.

$ osk list
$ osk ls --json

update

Check for updates and apply them.

$ osk update
$ osk up --check  # Check only, don't apply

search

Search for skills across configured repositories.

$ osk search "testing"
$ osk s "review" --agent claude

browse

Interactive skill browser with filtering.

$ osk browse
$ osk b --repo my-skills

login

Authenticate with the OpenSkill marketplace using the device auth flow. Opens a browser to complete authentication.

$ osk login

logout

Log out of the marketplace and revoke the current token.

$ osk logout

whoami

Show the current login status and authenticated user.

$ osk whoami

push

Push a skill to the marketplace as a draft. The skill must pass validation before it can be pushed.

$ osk push ./my-skill

# Push from current directory
$ osk push

publish

Make a previously pushed draft skill public and visible in search results.

$ osk publish my-skill

audit

Run a security audit on a local skill to check for potential issues before publishing.

$ osk audit ./my-skill/SKILL.md

# Audit current directory
$ osk audit

repo

Manage skill repositories.

$ osk repo add https://github.com/user/skills
$ osk repo ls
$ osk repo rm my-skills
$ osk repo sync

config

View and modify CLI configuration.

$ osk config list
$ osk config get defaultAgent
$ osk config set defaultAgent claude

init

Create a new skill template.

$ osk init my-skill
$ osk init my-skill --agent claude --template basic

validate

Validate a skill's format and frontmatter.

$ osk validate ./my-skill/SKILL.md
$ osk validate  # Validates current directory