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

npx @groupby/ai-dev

Or install as a dev dependency:

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

Requires Node.js >= 18

Usage

Interactive mode (default)

npx @groupby/ai-dev

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

List available skills and teams

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

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

Install all skills for a team

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

# Install dependencies
npm install

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

# Output is in dist/

Running tests

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

Tests use Vitest 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.

Repository

This package lives in the cli/ directory of ai-dev-shared.