openskill-cli

                            _    _ _ _
  ___  _ __   ___ _ __  ___| | _(_) | |
 / _ \| '_ \ / _ \ '_ \/ __| |/ / | | |
| (_) | |_) |  __/ | | \__ \   <| | | |
 \___/| .__/ \___|_| |_|___/_|\_\_|_|_|
      |_|

OpenSkill (osk)

Agent-agnostic skill manager for AI coding assistants

OpenSkill is a lightweight CLI tool for managing skills across multiple AI coding agents. Install, update, and share skills seamlessly across Claude Code, Cursor, OpenAI Codex, Antigravity, Gemini CLI, GitHub Copilot, OpenCode, Windsurf, Kiro, Warp, OpenClaw, and the generic Agents spec.

Features

• Multi-agent support - Works with 12 agents: Claude Code, Cursor, Codex, Antigravity, Gemini, Copilot, OpenCode, Windsurf, Kiro, Warp, OpenClaw, and the Agents spec
• Unified skill format - SKILL.md format compatible across all agents
• Project & global scopes - Install skills per-project or globally
• Repository management - Browse, search, and sync skill repositories
• Interactive installation - Searchable multi-select for easy skill discovery

Installation

npm install -g openskill-cli

Quick Start

# Browse available skills
osk browse

# Search for a skill
osk search pdf

# Install a skill (interactive)
osk install anthropics/skills

# Install specific skill to specific agent
osk install anthropics/skills pdf -t claude

# Install globally (available in all projects)
osk install anthropics/skills pdf -g

# List installed skills
osk ls

# Update skills
osk update

Commands

Command	Alias	Description
install <source> [skill]	i	Install skills from a repository
uninstall <skill>	rm	Remove installed skills
list	ls	List installed skills
update	up	Check and apply skill updates
search <query>	s	Search for skills in repositories
browse	b	Browse available skills
login		Authenticate with the marketplace
logout		Log out and revoke token
whoami		Show current login status
push [path]		Push skill to marketplace as draft
publish <slug>		Make a pushed skill public
audit [path]		Run security audit on a skill
repo add <source>		Add a skill repository
repo ls		List configured repositories
repo rm <name>		Remove a repository
repo sync [name]		Sync repositories (fetch latest)
repo info <name>		Show repository details
config		Manage configuration
init		Create a new skill
validate		Validate skill format
convert		Convert skills between formats
which		Show installation path for a skill
man		Show detailed help
completion		Generate shell completion script

Supported Agents

Agent	Project Path	Global Path
Claude Code	.claude/skills/	~/.claude/skills/
Cursor	.cursor/skills/	~/.cursor/skills/
OpenAI Codex	.codex/skills/	~/.codex/skills/
Antigravity	.antigravity/skills/	~/.antigravity/skills/

Skill Format

Skills use the SKILL.md format with YAML frontmatter:

---
name: my-skill
description: A short description of what this skill does
license: MIT
---

# Instructions

Your skill instructions go here in markdown format.

Configuration

Configuration is stored at ~/.openskill/config.json.

# Show current config
osk config

# Set default agent
osk config set defaultAgent cursor

# Set default scope (project or global)
osk config set defaultScope global

Repository Management

# List configured repositories
osk repo ls

# Add a repository (GitHub shorthand)
osk repo add owner/repo

# Add from GitLab
osk repo add https://gitlab.com/user/repo

# Add via SSH
osk repo add [e-mail]:user/repo.git --name my-skills

# Sync all repositories
osk repo sync

# Show repository details
osk repo info anthropic-official

# Remove a repository
osk repo rm my-skills

Shell Completion

Generate shell completion scripts for your shell:

# Bash
osk completion bash >> ~/.bashrc

# Zsh
osk completion zsh >> ~/.zshrc

# Fish
osk completion fish > ~/.config/fish/completions/osk.fish

Default Repositories

OpenSkill comes pre-configured with official skill repositories:

• anthropic-official - https://github.com/anthropics/skills
• openai-official - https://github.com/openai/skills

You can add any Git repository (GitHub, GitLab, self-hosted, SSH) using osk repo add.

Documentation

Full documentation is available in the docs/ directory:

• Getting Started - Installation and first steps
• Commands - Complete command reference
• Agents - Supported agents and configuration
• Skills - Skill format and creation guide
• Repositories - Managing skill repositories
• Architecture - Project structure and internals

Contributing

See CONTRIBUTING.md for development setup and guidelines.

License

MIT