_ _ _ _
___ _ __ ___ _ __ ___| | _(_) | |
/ _ \| '_ \ / _ \ '_ \/ __| |/ / | | |
| (_) | |_) | __/ | | \__ \ <| | | |
\___/| .__/ \___|_| |_|___/_|\_\_|_|_|
|_|
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.
- 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
npm install -g openskill-cli# 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| 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 |
| 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/ |
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 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# 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 git@github.com: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-skillsGenerate shell completion scripts for your shell:
# Bash
osk completion bash >> ~/.bashrc
# Zsh
osk completion zsh >> ~/.zshrc
# Fish
osk completion fish > ~/.config/fish/completions/osk.fishOpenSkill 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.
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
See CONTRIBUTING.md for development setup and guidelines.
MIT