open-index/open-npm huggingface dataset:
npm package: @groupby/ai-dev
Description: Interactive installer for Rezolve Ai development skills
Latest version: 0.2.1

# @groupby/ai-dev

Interactive CLI installer for Rezolve Ai development skills.

Discover, browse, and install shared AI skills (SKILL.md files) into any project with automatic client detection for **GitHub Copilot**, **Claude Code**, and **Codex**.

## Installation

Run directly with `npx` — no global install required:

```sh
npx @groupby/ai-dev
```

Or install as a dev dependency:

```sh
npm install --save-dev @groupby/ai-dev
```

> Requires Node.js >= 18

## Usage

### Interactive mode (default)

```sh
npx @groupby/ai-dev
```

Walks you through selecting and installing skills via an interactive prompt.

### List available skills and teams

```sh
npx @groupby/ai-dev list            # List everything
npx @groupby/ai-dev list skills     # List skills only
npx @groupby/ai-dev list teams      # List teams only
```

### Install a specific skill

```sh
npx @groupby/ai-dev install skill <skill-name>
```

### Install all skills for a team

```sh
npx @groupby/ai-dev install team <team-name>
```

When installing a team's skills, you will be prompted to optionally include skills from the shared library as well.

### Options

| Flag | Description |
| --- | --- |
| `--target <dir>` | Install into a specific directory (defaults to cwd) |
| `--dry-run` | Preview what would be installed without writing files |
| `--force` | Overwrite existing files without prompting |
| `--skip-existing` | Skip files that already exist |

## How it works

1. **Discovery** — The CLI scans bundled `skills/` and `teams/` directories for `SKILL.md` files and reads their YAML frontmatter (name, description, etc.).
2. **Client detection** — It checks the target project for known config directories (`.github/`, `.claude/`, `.agents/`) to determine which LLM clients are in use.
3. **Installation** — Each selected skill is copied into `docs/ai/skills/<name>/` and a stub `SKILL.md` is generated in each client's skills directory pointing back to the full skill file.
4. **Conflict handling** — If a file already exists and its content differs, you are prompted to overwrite or skip (unless `--force` or `--skip-existing` is set).

## Supported clients

| Client | Skills directory | Detected by |
| --- | --- | --- |
| GitHub Copilot | `.github/skills/` | `.github/` |
| Claude Code | `.claude/skills/` | `.claude/` |
| Codex | `.agents/skills/` | `.agents/` |

## Development

```sh
# Install dependencies
npm install

# Build (also copies skills/ and teams/ from the repo root)
npm run build

# Output is in dist/
```

### Running tests

```sh
npm test           # Run all tests once
npm run test:watch # Watch mode (re-runs on file changes)
```

Tests use [Vitest](https://vitest.dev/) and cover frontmatter parsing, skill discovery, installation logic, and SKILL.md validation across the repo.

The CLI is written in TypeScript and bundled to ESM with [tsup](https://github.com/egoist/tsup).

## Repository

This package lives in the `cli/` directory of [ai-dev-shared](https://github.com/rezolved/ai-dev-shared).