@groupby/ai-dev 0.1.0 → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +95 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
# @groupby/ai-dev
|
|
2
|
+
|
|
3
|
+
Interactive CLI installer for Rezolve Ai development skills.
|
|
4
|
+
|
|
5
|
+
Discover, browse, and install shared AI skills (SKILL.md files) into any project with automatic client detection for **GitHub Copilot**, **Claude Code**, and **Codex**.
|
|
6
|
+
|
|
7
|
+
## Installation
|
|
8
|
+
|
|
9
|
+
Run directly with `npx` — no global install required:
|
|
10
|
+
|
|
11
|
+
```sh
|
|
12
|
+
npx @groupby/ai-dev
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
Or install as a dev dependency:
|
|
16
|
+
|
|
17
|
+
```sh
|
|
18
|
+
npm install --save-dev @groupby/ai-dev
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
> Requires Node.js >= 18
|
|
22
|
+
|
|
23
|
+
## Usage
|
|
24
|
+
|
|
25
|
+
### Interactive mode (default)
|
|
26
|
+
|
|
27
|
+
```sh
|
|
28
|
+
npx @groupby/ai-dev
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
Walks you through selecting and installing skills via an interactive prompt.
|
|
32
|
+
|
|
33
|
+
### List available skills and teams
|
|
34
|
+
|
|
35
|
+
```sh
|
|
36
|
+
npx @groupby/ai-dev list # List everything
|
|
37
|
+
npx @groupby/ai-dev list skills # List skills only
|
|
38
|
+
npx @groupby/ai-dev list teams # List teams only
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
### Install a specific skill
|
|
42
|
+
|
|
43
|
+
```sh
|
|
44
|
+
npx @groupby/ai-dev install skill <skill-name>
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
### Install all skills for a team
|
|
48
|
+
|
|
49
|
+
```sh
|
|
50
|
+
npx @groupby/ai-dev install team <team-name>
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
When installing a team's skills, you will be prompted to optionally include skills from the shared library as well.
|
|
54
|
+
|
|
55
|
+
### Options
|
|
56
|
+
|
|
57
|
+
| Flag | Description |
|
|
58
|
+
| --- | --- |
|
|
59
|
+
| `--target <dir>` | Install into a specific directory (defaults to cwd) |
|
|
60
|
+
| `--dry-run` | Preview what would be installed without writing files |
|
|
61
|
+
| `--force` | Overwrite existing files without prompting |
|
|
62
|
+
| `--skip-existing` | Skip files that already exist |
|
|
63
|
+
|
|
64
|
+
## How it works
|
|
65
|
+
|
|
66
|
+
1. **Discovery** — The CLI scans bundled `skills/` and `teams/` directories for `SKILL.md` files and reads their YAML frontmatter (name, description, etc.).
|
|
67
|
+
2. **Client detection** — It checks the target project for known config directories (`.github/`, `.claude/`, `.agents/`) to determine which LLM clients are in use.
|
|
68
|
+
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.
|
|
69
|
+
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).
|
|
70
|
+
|
|
71
|
+
## Supported clients
|
|
72
|
+
|
|
73
|
+
| Client | Skills directory | Detected by |
|
|
74
|
+
| --- | --- | --- |
|
|
75
|
+
| GitHub Copilot | `.github/skills/` | `.github/` |
|
|
76
|
+
| Claude Code | `.claude/skills/` | `.claude/` |
|
|
77
|
+
| Codex | `.agents/skills/` | `.agents/` |
|
|
78
|
+
|
|
79
|
+
## Development
|
|
80
|
+
|
|
81
|
+
```sh
|
|
82
|
+
# Install dependencies
|
|
83
|
+
npm install
|
|
84
|
+
|
|
85
|
+
# Build (also copies skills/ and teams/ from the repo root)
|
|
86
|
+
npm run build
|
|
87
|
+
|
|
88
|
+
# Output is in dist/
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
The CLI is written in TypeScript and bundled to ESM with [tsup](https://github.com/egoist/tsup).
|
|
92
|
+
|
|
93
|
+
## Repository
|
|
94
|
+
|
|
95
|
+
This package lives in the `cli/` directory of [ai-dev-shared](https://github.com/rezolved/ai-dev-shared).
|