skills-installer

# Plaited Skills Installer

[![CI](https://github.com/plaited/skills-installer/actions/workflows/ci.yml/badge.svg)](https://github.com/plaited/skills-installer/actions/workflows/ci.yml)
[![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/licenses/ISC)

Install Plaited skills for AI coding agents supporting the agent-skills-spec.

## Requirements

- **macOS / Linux**: Works out of the box
- **Windows**: Requires one of:
  - WSL (Windows Subsystem for Linux) - recommended
  - Developer Mode enabled (for symlink support)

The installer uses symlinks to avoid duplicating skill files across multiple agents. Windows requires special permissions or WSL for symlink creation.

## Installation

For agents supporting the agent-skills-spec (Cursor CLI, GitHub Copilot, Cursor, OpenCode, Amp, Goose, Factory, Codex, Windsurf, Claude Code):

```bash
# Install for multiple agents
curl -fsSL https://raw.githubusercontent.com/plaited/skills-installer/main/install.sh | bash -s -- --agents cursor,cursor

# Install a specific project
curl -fsSL https://raw.githubusercontent.com/plaited/skills-installer/main/install.sh | bash -s -- --agents cursor --project development-skills
```

**Or clone and run locally:**

```bash
git clone https://github.com/plaited/skills-installer.git
cd skills-installer
./install.sh                              # Interactive mode (multi-select agents)
./install.sh --agents cursor,cursor       # Install for multiple agents
./install.sh --agents cursor --project agent-eval-harness  # Specific project
./install.sh --list                       # List available projects
./install.sh --uninstall                  # Remove all
```

## Architecture

Skills are installed to a central `.plaited/skills/` directory and symlinked to each agent's skills directory:

```
.plaited/skills/                          # Central storage (single copy)
  skill-name@org_project/

.cursor/skills/                           # Symlinks
  skill-name@org_p