@groupby/ai-dev

Interactive CLI installer for Rezolve Ai development skills, prompts, and resources.

Discover, browse, and install shared AI skills (SKILL.md files), team prompts, team resources, and other team content folders 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 >= 20

Usage

Interactive mode (default)

npx @groupby/ai-dev

Walks you through selecting and installing AI content via interactive prompts.

List available content

npx @groupby/ai-dev list            # List everything
npx @groupby/ai-dev list skills     # List skills only
npx @groupby/ai-dev list teams      # List teams and content counts

Install a specific skill

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

Install all team content

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

This installs the team's skills, prompts, and resources. A team's prompts/ folder lands beside skills/ under the AI directory, for example docs/ai/prompts/. A team's resources/ folder installs to docs/ai/resources/. Other direct team content folders follow the same pattern. Installing a specific team or toolset skill also installs resources from that skill's owning team or toolset. You will also be prompted to optionally include skills from the shared library.

Options

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

--ai-dir is resolved relative to --target and is intentionally flexible. Parent-directory segments such as ../shared-ai are supported so teams can keep AI docs in a workspace-level or shared location while client stubs stay in the target project. Use --dry-run first when trying a new install layout. Direct install subcommands use these options instead of prompting for a location. Interactive mode (npx @groupby/ai-dev) prompts for the AI content directory before showing the final install summary.

How it works

1. Discovery — The CLI scans bundled skills/, teams/, and toolsets/ directories for SKILL.md files, team prompts, team resources, and other team content folders.
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 <ai-dir>/skills/<name>/ (default: docs/ai/skills/<name>/) and a stub SKILL.md is generated in each client's skills directory pointing back to the full skill file. Team prompts, resources, and other content folders are copied beside skills/, such as <ai-dir>/prompts/ and <ai-dir>/resources/. Installing a skill also installs resources from its owning team or toolset.
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).
5. Path patching — When --ai-dir is set to a non-default value, any docs/ai/ references inside installed .md files are replaced with the custom path so LLMs can find resource files at runtime.

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/, teams/, and toolsets/ 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.