oskill
v0.2.2
Published
TUI-based skill manager for AI coding agents
Maintainers
Readme
oskill
🛠️ TUI-based skill manager for AI coding agents
Install and manage skills across multiple AI coding agents from a single terminal interface.
Features
- 🎯 Multi-agent support — Install skills to Cursor, Windsurf, Claude Code, OpenCode, Gemini CLI, and more
- 📦 Multiple sources — Install from GitHub repos or local directories
- 🌍 Global/Local scope — Install skills globally or per-project
- 🔄 Update detection — Check for and apply skill updates
- ⌨️ Keyboard-driven — Full TUI with intuitive navigation
Installation
npm install -g oskillUsage
oskillWorkflow
Enter source — Provide a GitHub URL or local path
vercel-labs/agent-skills ./my-local-skills https://github.com/user/repoSelect skills — Use arrow keys and Space to select
Select agents — Choose target AI agents
Install — Press Enter on the Install button
Keyboard Shortcuts
| Key | Action |
|-----|--------|
| Tab | Cycle through sections |
| ↑/↓ or j/k | Navigate lists |
| Space/Enter | Toggle selection |
| g | Toggle Global/Local scope |
| Ctrl+U | Check for updates |
| ESC | Go back / Exit |
Supported Agents
| Agent | Local Dir | Global Dir |
|-------|-----------|------------|
| OpenCode | .opencode/skill | ~/.config/opencode/skill |
| Claude Code | .claude/skills | ~/.claude/skills |
| Cursor | .cursor/skills | ~/.cursor/skills |
| Windsurf | .windsurf/skills | ~/.codeium/windsurf/skills |
| Gemini CLI | .gemini/skills | ~/.gemini/skills |
| Antigravity | .agent/skills | ~/.gemini/antigravity/skills |
| GitHub Copilot | .github/skills | ~/.copilot/skills |
| Amp | .agents/skills | ~/.config/agents/skills |
| Goose | .goose/skills | ~/.config/goose/skills |
| Kilo Code | .kilocode/skills | ~/.kilocode/skills |
| Roo Code | .roo/skills | ~/.roo/skills |
| Codex | .codex/skills | ~/.codex/skills |
Creating Skills
A skill is a directory containing a SKILL.md file with YAML frontmatter:
---
name: my-skill
description: A helpful skill for coding agents
---
# My Skill
Instructions for the AI agent...Development
# Install dependencies
bun install
# Run in development mode
bun run dev
# Build for production
bun run buildLicense
MIT © Charl Kruger
