skill

```
 (`-').-><-.(`-')  _                       
 ( OO)_   __( OO) (_)      <-.      <-.    
(_)--\_) '-'. ,--.,-(`-'),--. )   ,--. )   
/    _ / |  .'   /| ( OO)|  (`-') |  (`-') 
\_..`--. |      /)|  |  )|  |OO ) |  |OO ) 
.-._)   \|  .   '(|  |_/(|  '__ |(|  '__ | 
\       /|  |\   \|  |'->|     |' |     |' 
 `-----' `--' '--'`--'   `-----'  `-----'
```

Manage agent “skills” from GitHub repos: browse, install, sync updates, uninstall, and apply them to your projects individually. 

## Features
- Browse skills in a repo with an interactive TUI (search + multi-select)
- Install selected skills pinned to a commit (reproducible installs)
- Sync a trusted source to install missing skills and update installed ones
- Browse installed skills and uninstall them from a TUI
- Apply installed skills to supported agents (Claude Code, Cursor, VS Code, Cursor, Goose, OpenCode, Codex)

## Installation
Requirements: `git` and an interactive terminal.

macOS (Homebrew):
```bash
brew tap philipesteiff/tap
brew install skill
```

macOS (curl installer):
```bash
curl -fsSL https://raw.githubusercontent.com/philipesteiff/skill/main/scripts/install.sh | bash
```

From source (any OS with Rust):
```bash
cargo install --git https://github.com/philipesteiff/skill --locked --bin skill
```

## Usage
Skill scans `SKILL.md` files recursively, including repository root (for single-skill repos).

Browse a repo and install skills:
```bash
skill browse owner/repo
```
![Browse skills TUI](docs/screenshots/browse.png)

Browse installed skills and uninstall (select skills → Enter):
```bash
skill browse
```

Sync updates:
```bash
# sync all configured sources
skill sync

# sync one source by id (first browse trusts a source and saves an id)
skill sync @owner-repo
```

Apply installed skills to agent directories (TUI):
```bash
skill apply
```
![Apply skills TUI](docs/screenshots/apply.png)

![Select targets TUI](docs/screenshots/apply_selection.png)

Applied skills are copied as real folders (not sym