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

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 between Claude Code, Cursor, OpenAI Codex, and Antigravity.

Features

• Multi-agent support - Works with Claude Code, Cursor, OpenAI Codex, and Antigravity
• 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 | | 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 [email protected]: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