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

``bash
npm install -g oskill
`

Usage

`bash
oskill
`

$3

1. Enter source — Provide a GitHub URL or local path
`
vercel-labs/agent-skills
./my-local-skills
https://github.com/user/repo
`

2. Select skills — Use arrow keys and Space to select
3. Select agents — Choose target AI agents
4. Install — Press Enter on the Install button

$3

| 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:

`markdown
---
name: my-skill
description: A helpful skill for coding agents
---

My Skill

Instructions for the AI agent...
`

Development

`bash


Install dependencies

bun install

Run in development mode

bun run dev

Build for production

bun run build
``

License

MIT © Charl Kruger