@mhmdreza-rafiei/agentry 0.2.0 → 0.2.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 CHANGED
@@ -1,259 +1,198 @@
1
1
  <div align="center">
2
2
 
3
- <img src="docs/agentry-logo.png" alt="agentry" width="800" />
3
+ # Agentry
4
4
 
5
- **A raw installer for AI agent tooling.**
5
+ **Install agents, skills, rules, scripts, and profiles onto coding agents — from any Git repo.**
6
6
 
7
- `agentry` fetches **agents, skills, rules, scripts, and profiles** from any Git repo (or local path) and installs the ones you pick into your project — or globally — under each target provider's directory (`.cursor/`, `.claude/skills/`, `.agents/skills/`, …). The CLI ships no assets of its own; you point it at a source.
7
+ Supports **Cursor**, **Claude Code**, **Codex**, **OpenCode**, and [70+ more](#supported-agents).
8
8
 
9
- It mirrors the clean Clack-style UX of [`vercel-labs/skills`](https://github.com/vercel-labs/skills) and extends it beyond skills-only. Supports **70+ agent providers**.
10
-
11
- [![npm version](https://img.shields.io/npm/v/@mhmdreza-rafiei/agentry.svg?style=flat&color=cyan)](https://www.npmjs.com/package/@mhmdreza-rafiei/agentry)
12
- [![license](https://img.shields.io/badge/license-MIT-cyan.svg?style=flat)](#license)
13
- [![node](https://img.shields.io/badge/node-%3E%3D22.20-cyan.svg?style=flat)](#development--test)
9
+ [![npm](https://img.shields.io/npm/v/@mhmdreza-rafiei/agentry?style=flat&color=38bdf8)](https://www.npmjs.com/package/@mhmdreza-rafiei/agentry)
10
+ [![node](https://img.shields.io/badge/node-%3E%3D22.20-38bdf8?style=flat)](#install)
11
+ [![license](https://img.shields.io/badge/license-MIT-38bdf8?style=flat)](LICENSE)
14
12
  [![stars](https://img.shields.io/github/stars/mhmdreza-rafiei/agentry?style=social)](https://github.com/mhmdreza-rafiei/agentry)
15
13
 
16
- ⭐ If agentry saves you time, [star the repo](https://github.com/mhmdreza-rafiei/agentry) — it helps others find it.
17
-
18
14
  </div>
19
15
 
20
- ---
16
+ ## Install
21
17
 
22
- ## Install / run
18
+ ```bash
19
+ npm install -g @mhmdreza-rafiei/agentry
20
+ # or
21
+ npx @mhmdreza-rafiei/agentry@latest --help
22
+ ```
23
+
24
+ ## Quick start
23
25
 
24
26
  ```bash
25
- # Run without installing (recommended)
26
- npx agentry@latest --help
27
+ # Browse + install skills from a repo
28
+ agentry add skills mhmdreza-rafiei/agent-tools
27
29
 
28
- # Or install the CLI globally
29
- npm install -g agentry@latest
30
+ # Install one skill to Cursor
31
+ agentry add skills mhmdreza-rafiei/agent-tools enhance-prompt -a cursor
30
32
 
31
- # Update / uninstall the CLI
32
- agentry update
33
- agentry uninstall
33
+ # See what is installed
34
+ agentry list
35
+ agentry list skills
34
36
  ```
35
37
 
36
- > Publishing to npm is pending. Until then, run from a clone: `node dist/cli.mjs …` (after `npm run build`) or `npm run dev -- …`.
38
+ ## Commands
37
39
 
38
- ## Usage
40
+ | Command | Description |
41
+ | --- | --- |
42
+ | `agentry add <kind> <source> [selector]` | Discover and install artifacts |
43
+ | `agentry add profile <name> [source]` | Apply a local `profile/<name>.yaml` bundle |
44
+ | `agentry list` | List installed artifacts |
45
+ | `agentry list <kind>` | List installed artifacts of one kind |
46
+ | `agentry list <source> [kind] [selector]` | List what a repo/path contains |
47
+ | `agentry remove <kind> [source] [selector]` | Remove installs (files + lock) |
48
+ | `agentry update [kind] [source] [selector]` | Re-install from source or lockfile |
49
+ | `agentry init <kind> [name] [category]` | Scaffold a new artifact |
50
+ | `agentry update` | Update the Agentry CLI itself |
51
+ | `agentry uninstall` | Uninstall the Agentry CLI |
39
52
 
40
- ```
41
- agentry add <kind> <source> [category/name | category] [options]
42
- agentry add profile <name> [source] [options]
43
- agentry remove <kind> [category/name | category] [options]
44
- agentry list [source] [kind]
45
- agentry update [kind] [source] [selector]
46
- agentry uninstall
47
- ```
53
+ `<kind>` is `skill | rule | agent | profile | script` (plurals accepted).
48
54
 
49
- `<kind>` is `skill | rule | agent | profile | script` (singular; plurals like `skills` are accepted and normalized). `<source>` is a GitHub shorthand `author/repo`, a full GitHub URL, a GitHub tree subdir URL, a GitLab URL, any git URL, or a local path.
55
+ ### Source formats
50
56
 
51
57
  ```bash
52
- agentry add skills Prat011/awesome-llm-skills # list all skills and pick
53
- agentry add skills Prat011/awesome-llm-skills video-downloader # one skill (no category)
54
- agentry add skills Prat011/awesome-llm-skills document-skills/docx # one skill (category/name)
55
- agentry add skills ./my-skills --list # preview only, no install
56
- agentry add skills ./my-skills prompt/enhance-prompt -a cursor -a claude-code # install to 2 providers
57
- agentry add agents author/repo frontend-developer # one agent (.mdc file)
58
- agentry add rules author/repo ask-dont-guess # one rule (.mdc file)
59
- agentry add scripts author/repo lint # one script (usecase folder)
60
- agentry add profile frontend author/repo # apply profile/frontend.yaml
61
- agentry remove skills document-skills/docx # remove an installed artifact
62
- agentry list author/repo
63
- agentry update # self-update (checks version first)
64
- agentry update skills author/repo prompt/enhance-prompt # re-install one artifact from source
65
- agentry update skills # re-install all skills from lockfile sources
66
- agentry uninstall # remove the CLI
67
- ```
58
+ # GitHub shorthand
59
+ agentry add skills mhmdreza-rafiei/agent-tools
68
60
 
69
- Flags: `-g, --global` (into `~`), `--project` (current folder, default), `--dir <path>`, `-a, --agent <name>` (repeatable; `*` for all; default: prompt to choose), `-l, --list` (preview, no install), `--copy` (copy files instead of symlinking), `--all` (install everything to all agents, no prompts), `-y, --yes` (no prompts), `-v, --version`, `-h, --help`.
61
+ # Full GitHub URL
62
+ agentry add skills https://github.com/mhmdreza-rafiei/agent-tools
70
63
 
71
- When you run `agentry add` without `--agent`, it shows a **fetch animation** (parsing source → discovering → found N), lets you **pick artifacts** (with an `All` toggle), then prompts **"Which agents do you want to install to?"** — universal providers (`.agents/skills`) are locked in and others are selectable, defaulting to the providers you already have installed. The interactive UI (animated robot logo, spinners, prompts) is suppressed automatically when running inside an agent or CI; non-interactive runs default to the current project and auto-detected providers.
64
+ # Tree URL (subdir + ref)
65
+ agentry add skills https://github.com/mhmdreza-rafiei/agent-tools/tree/main/skills
72
66
 
73
- ## How sources are discovered
67
+ # Local path
68
+ agentry add skills ./my-skills
74
69
 
75
- For each kind, `agentry` finds artifacts in two ways and merges them:
70
+ # Any git URL
71
+ agentry add skills git@github.com:mhmdreza-rafiei/agent-tools.git
72
+ ```
76
73
 
77
- 1. Under an explicit `<kind>s/` folder (see artifact layouts below).
78
- 2. At the repo root by marker — a folder with `SKILL.md` is a skill; a `.mdc` file at root is an agent or rule. (Scripts and profiles are folder/file kinds found only under their `scripts/` and `profiles/` folders.)
74
+ ### Options
79
75
 
80
- Selectors after the source: `category/name` (one artifact), `name` (one artifact when uncategorized), `category` (whole category), or omit to list-and-pick.
76
+ | Option | Description |
77
+ | --- | --- |
78
+ | `-g, --global` | Install into `~` (all projects) |
79
+ | `--project` | Install into the current folder (default) |
80
+ | `--dir <path>` | Install into a specific folder |
81
+ | `-a, --agent <name>` | Target provider(s); repeatable; `*` = all |
82
+ | `-l, --list` | Preview only — write nothing |
83
+ | `--copy` | Copy instead of symlink for non-universal agents |
84
+ | `--all` | Install everything to all agents, no prompts |
85
+ | `-y, --yes` | Skip prompts |
86
+ | `--description <text>` | `init`: frontmatter description |
87
+ | `--alwaysApply` | `init` rule: `alwaysApply: true` |
88
+ | `--reference` / `--no-reference` | `init` skill: include `references/TEMPLATE.md` |
89
+ | `--skills` / `--agents` / `--rules` / `--scripts` `[src]` | `init` profile: include kinds (optional source) |
81
90
 
82
- Artifacts install to the provider's directory and are tracked in `.agentry/lock.json` for idempotent installs and clean removal. `remove` works purely on installed files, so it needs no source.
91
+ ## Examples
83
92
 
84
- ## Artifact layouts (how to create installable tools)
93
+ ```bash
94
+ # List everything in a catalog repo
95
+ agentry list mhmdreza-rafiei/agent-tools
96
+ agentry list mhmdreza-rafiei/agent-tools skills
97
+ agentry list mhmdreza-rafiei/agent-tools skills enhance-prompt
85
98
 
86
- Create artifacts in your repo using these layouts, then `agentry add` from your repo:
99
+ # Install
100
+ agentry add skills mhmdreza-rafiei/agent-tools
101
+ agentry add skills mhmdreza-rafiei/agent-tools enhance-prompt -a cursor -a claude-code
102
+ agentry add rules mhmdreza-rafiei/agent-tools ask-dont-guess
103
+ agentry add agents mhmdreza-rafiei/agent-tools frontend-developer
87
104
 
88
- ### Skills — folder per skill
105
+ # Inventory
106
+ agentry list
107
+ agentry list skills
89
108
 
90
- ```
91
- skills/
92
- enhance-prompt/
93
- SKILL.md # YAML frontmatter: name, description
94
- references/
95
- TEMPLATE.md # optional supporting docs
96
- ...
97
- ```
109
+ # Update / remove by selector or by install source
110
+ agentry update skills mhmdreza-rafiei/agent-tools
111
+ agentry remove skills enhance-prompt
112
+ agentry remove skills mhmdreza-rafiei/agent-tools
98
113
 
99
- `SKILL.md` frontmatter:
100
-
101
- ```yaml
102
- ---
103
- name: enhance-prompt
104
- description: Rewrite a user message into a precise, portable agent prompt.
105
- ---
106
- # enhance-prompt
107
- Instructions for the agent...
114
+ # Scaffold
115
+ agentry init skill enhance-prompt prompt --reference
116
+ agentry init rule ask-dont-guess --alwaysApply --description "Ask before guessing"
117
+ agentry init profile frontend --skills mhmdreza-rafiei/agent-tools -a cursor
108
118
  ```
109
119
 
110
- Categorized skills: `skills/<category>/<name>/SKILL.md`.
120
+ Example catalog used throughout this README: [`mhmdreza-rafiei/agent-tools`](https://github.com/mhmdreza-rafiei/agent-tools).
111
121
 
112
- ### Agents — single `.mdc` file
122
+ ## How it works
113
123
 
114
- ```
115
- agents/
116
- frontend-developer.mdc
117
- ```
124
+ 1. Resolve a source (local path or shallow git clone).
125
+ 2. Discover artifacts under `<kind>s/` **and** root markers (`SKILL.md`, `.mdc`).
126
+ 3. Let you pick what to install (searchable list + `All`).
127
+ 4. Install once to `.agents/skills/<id>` for universal providers; symlink (or `--copy`) for others.
128
+ 5. Track installs in `.agentry/lock.json` for remove/update.
118
129
 
119
- `.mdc` frontmatter (same shape as skills):
130
+ If a clone fails and a prior cache exists, Agentry asks whether to load from cache (`~/.cache/agentry/repos`).
120
131
 
121
- ```yaml
122
- ---
123
- name: frontend-developer
124
- description: Senior frontend engineer agent.
125
- ---
126
- # frontend-developer
127
- Agent instructions...
128
- ```
132
+ ## Artifact layouts
129
133
 
130
- Categorized agents: `agents/<category>/<name>.mdc`.
134
+ Author installable tools in a source repo like this:
131
135
 
132
- ### Rules — single `.mdc` file
136
+ ### Skills
133
137
 
138
+ ```text
139
+ skills/
140
+ enhance-prompt/
141
+ SKILL.md
142
+ references/
143
+ TEMPLATE.md
144
+ prompt/
145
+ rewrite/
146
+ SKILL.md
134
147
  ```
148
+
149
+ ### Agents / rules
150
+
151
+ ```text
152
+ agents/
153
+ frontend-developer.mdc
135
154
  rules/
136
155
  ask-dont-guess.mdc
137
156
  ```
138
157
 
139
- Same frontmatter and body shape as agents. Categorized rules: `rules/<category>/<name>.mdc`.
140
-
141
- ### Scripts — folder per use case
158
+ ### Scripts / profiles
142
159
 
143
- ```
160
+ ```text
144
161
  scripts/
145
- lint/
146
- run.js # entrypoint (any language; a folder with files = one script)
147
- README.md # optional docs
148
- format/
149
- run.js
150
- ```
151
-
152
- A script is a **folder** containing its files (entrypoint, helpers, docs). Categorized scripts: `scripts/<category>/<usecase>/`.
153
-
154
- ### Profiles — single `.yaml` file (in a source repo)
155
-
156
- ```
162
+ deploy/
163
+ README.md
157
164
  profiles/
158
165
  frontend.yaml
159
166
  ```
160
167
 
161
- A profile bundles artifact selectors + target agents + scope into one config. See the **Profiles** section below for the schema. Categorized profiles: `profiles/<category>/<name>.yaml`.
162
-
163
- ## How to install tools with agentry
168
+ Local install profiles (consumed by `agentry add profile`) live at `profile/<name>.yaml`.
164
169
 
165
- ```bash
166
- # From a GitHub repo (author/repo shorthand)
167
- agentry add skills Prat011/awesome-llm-skills
168
-
169
- # From a full GitHub URL
170
- agentry add skills https://github.com/Prat011/awesome-llm-skills
171
-
172
- # From a subdirectory of a repo (GitHub tree URL)
173
- agentry add skills https://github.com/vercel-labs/agent-skills/tree/main/skills/web-design
174
-
175
- # From a GitLab URL
176
- agentry add skills https://gitlab.com/org/repo
177
-
178
- # From any git URL
179
- agentry add skills git@github.com:owner/repo.git
180
-
181
- # From a local path
182
- agentry add skills ./my-skills
183
-
184
- # Install to specific providers
185
- agentry add skills ./my-skills enhance-prompt --agent cursor --agent claude-code
186
-
187
- # Install to all providers
188
- agentry add skills ./my-skills enhance-prompt --agent '*'
170
+ ## Supported agents
189
171
 
190
- # Preview without installing
191
- agentry add skills ./my-skills --list
192
- ```
193
-
194
- ## Supported providers
195
-
196
- `agentry` installs into 70+ agent providers, mirroring vercel-labs/skills. Each provider has a project skills directory and a global one. A few common ones:
197
-
198
- | Provider | `--agent` | Project path | Global path |
199
- | -------------- | ---------------- | ------------------- | ----------------------------- |
200
- | Cursor | `cursor` | `.agents/skills/` | `~/.cursor/skills/` |
201
- | Claude Code | `claude-code` | `.claude/skills/` | `~/.claude/skills/` |
202
- | Codex | `codex` | `.agents/skills/` | `~/.codex/skills/` |
203
- | OpenCode | `opencode` | `.agents/skills/` | `~/.config/opencode/skills/` |
204
- | Gemini CLI | `gemini-cli` | `.agents/skills/` | `~/.gemini/skills/` |
205
- | Windsurf | `windsurf` | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
206
- | Cline | `cline` | `.agents/skills/` | `~/.agents/skills/` |
207
- | Amp | `amp` | `.agents/skills/` | `~/.config/agents/skills/` |
208
- | Goose | `goose` | `.goose/skills/` | `~/.config/goose/skills/` |
209
- | Roo Code | `roo` | `.roo/skills/` | `~/.roo/skills/` |
210
- | GitHub Copilot | `github-copilot` | `.agents/skills/` | `~/.copilot/skills/` |
211
- | Augment | `augment` | `.augment/skills/` | `~/.augment/skills/` |
212
- | Continue | `continue` | `.continue/skills/` | `~/.continue/skills/` |
213
- | Zed | `zed` | `.agents/skills/` | `~/.agents/skills/` |
214
- | Warp | `warp` | `.agents/skills/` | `~/.agents/skills/` |
215
-
216
- ...and 55+ more. The CLI auto-detects installed providers; pass `--agent` to target specific ones or `--agent '*'` for all.
217
-
218
- ### Universal install (`.agents/skills`)
219
-
220
- Providers whose skills directory is `.agents/skills/` (Cursor, Codex, OpenCode, Gemini CLI, Cline, Amp, Zed, Warp, GitHub Copilot, …) are **universal**: a skill is installed **once** to `.agents/skills/<id>` and every universal provider reads it from there. Non-universal providers (Claude Code, Windsurf, Goose, Roo, Augment, Continue, …) get a **symlink** from their own skills directory to the canonical `.agents/skills/<id>` copy, so a single install reaches all of them with no duplication. Use `--copy` to make independent copies instead of symlinks.
221
-
222
- ## Profiles
223
-
224
- A profile is a YAML file at `profile/<name>.yaml` in your project. It bundles artifact selectors, target agents, and scope; `agentry add profile <name> <source>` fetches the source once and installs everything the profile lists.
225
-
226
- ```yaml
227
- name: frontend
228
- description: Frontend agents, rules, and skills
229
- scope: project # project | global
230
- targets:
231
- agents: [cursor, claude-code] # target providers; '*' = all
232
- artifacts:
233
- skills:
234
- - id: prompt/enhance-prompt
235
- agents:
236
- - id: frontend-developer
237
- rules:
238
- - id: ask-dont-guess
239
- scripts:
240
- - id: lint
241
- ```
172
+ Agentry targets **70+** providers. Universal providers share `.agents/skills/`; others get a symlink or copy.
242
173
 
243
- Each artifact ref may override the CLI source with its own `source:`. The command-line `<source>` is the default for refs without one.
174
+ | Agent | Skills path |
175
+ | --- | --- |
176
+ | Cursor | `.agents/skills` |
177
+ | Codex | `.agents/skills` |
178
+ | OpenCode | `.agents/skills` |
179
+ | Gemini CLI | `.agents/skills` |
180
+ | Claude Code | `.claude/skills` |
181
+ | Windsurf | `.windsurf/skills` |
182
+ | … | see `src/registry/agents.ts` |
244
183
 
245
- ## Development / test
184
+ ## Development
246
185
 
247
186
  ```bash
248
- npm run typecheck # tsc --noEmit
249
- npm test # vitest (discovery, source parser, agents registry, install/remove, profiles)
250
- npm run build # obuild -> dist/cli.mjs
251
- npm run dev -- … # run via tsx (no build needed)
252
- node dist/cli.mjs … # run the built CLI
187
+ npm install
188
+ npm run typecheck
189
+ npm test
190
+ npm run build
191
+ node dist/cli.mjs --help
253
192
  ```
254
193
 
255
- `src/` holds the logic: `cli.ts` (router), `commands.ts` (handlers), `core/` (types, source-parser, git, lock), `registry/agents.ts` (70+ providers), `artifacts/` (discovery, profiles), `ui/` (theme, prompts, detect). Runtime deps are minimal and UI libs are bundled by `obuild`.
194
+ Requires **Node ≥ 22.20**.
256
195
 
257
196
  ## License
258
197
 
259
- MIT
198
+ [MIT](LICENSE)
@@ -1,16 +1,26 @@
1
1
  import c from "picocolors";
2
+ function fgSky(s) {
3
+ return `\x1b[38;2;56;189;248m${s}\x1b[0m`;
4
+ }
5
+ function bgSky(s) {
6
+ return `\x1b[48;2;14;165;233m${s}\x1b[0m`;
7
+ }
8
+ const sky = Object.assign((s) => fgSky(s), {
9
+ bold: (s) => c.bold(fgSky(s)),
10
+ bg: (s) => bgSky(s)
11
+ });
2
12
  const PALETTE = {
3
- primary: c.blue,
13
+ primary: sky,
4
14
  success: c.green,
5
15
  error: c.red,
6
16
  warn: c.yellow,
7
- info: c.blue,
17
+ info: sky,
8
18
  dim: c.dim,
9
19
  bold: c.bold,
10
20
  text: c.white
11
21
  };
12
22
  const theme = PALETTE;
13
- c.blue(process.stdout.isTTY ? "✓" : "v"), c.red(process.stdout.isTTY ? "✗" : "x"), c.yellow(process.stdout.isTTY ? "⚠" : "!"), c.blue(process.stdout.isTTY ? "ℹ" : "i"), process.stdout.isTTY, process.stdout.isTTY, process.stdout.isTTY;
23
+ sky(process.stdout.isTTY ? "✓" : "v"), c.red(process.stdout.isTTY ? "✗" : "x"), c.yellow(process.stdout.isTTY ? "⚠" : "!"), sky(process.stdout.isTTY ? "ℹ" : "i"), process.stdout.isTTY, process.stdout.isTTY, process.stdout.isTTY;
14
24
  const RESET = "\x1B[0m";
15
25
  const GRAYS = [
16
26
  "\x1B[38;5;255m",
@@ -44,7 +54,7 @@ function tagline() {
44
54
  return c.dim(" Install agents, skills, rules & profiles");
45
55
  }
46
56
  function badge() {
47
- return c.bgBlue(c.white(c.bold(" Agentry ")));
57
+ return bgSky(c.white(c.bold(" Agentry ")));
48
58
  }
49
59
  function delay(ms) {
50
60
  return new Promise((r) => setTimeout(r, ms));
@@ -55,19 +65,19 @@ async function animateLogo() {
55
65
  if (process.stdout.isTTY) await delay(280);
56
66
  }
57
67
  function h(title) {
58
- return c.bold(c.blue(title));
68
+ return c.bold(sky(title));
59
69
  }
60
70
  function cmd(s) {
61
71
  return c.cyan(s);
62
72
  }
63
73
  function flag(s) {
64
- return c.blue(s);
74
+ return sky(s);
65
75
  }
66
76
  function dim(s) {
67
77
  return c.dim(s);
68
78
  }
69
79
  function bullet(s) {
70
- return ` ${c.blue("•")} ${s}`;
80
+ return ` ${sky("•")} ${s}`;
71
81
  }
72
82
  function printHelp() {
73
83
  const lines = [
@@ -77,9 +87,10 @@ function printHelp() {
77
87
  h("Usage"),
78
88
  ` ${cmd("agentry")} ${flag("add")} ${dim("<kind> <source> [selector] [options]")}`,
79
89
  ` ${cmd("agentry")} ${flag("add")} ${dim("profile <name> [source] [options]")}`,
80
- ` ${cmd("agentry")} ${flag("remove")} ${dim("<kind> [selector] [options]")}`,
81
- ` ${cmd("agentry")} ${flag("list")} ${dim("[source] [kind]")}`,
90
+ ` ${cmd("agentry")} ${flag("remove")} ${dim("<kind> [source] [selector] [options]")}`,
91
+ ` ${cmd("agentry")} ${flag("list")} ${dim("[source] [kind] [selector]")}`,
82
92
  ` ${cmd("agentry")} ${flag("update")} ${dim("[kind] [source] [selector]")}`,
93
+ ` ${cmd("agentry")} ${flag("init")} ${dim("<kind> [name] [category] [options]")}`,
83
94
  ` ${cmd("agentry")} ${flag("uninstall")}`,
84
95
  "",
85
96
  h("Kinds"),
@@ -94,14 +105,20 @@ function printHelp() {
94
105
  bullet(`${cmd("./path")} ${dim("|")} ${cmd("/path")} ${dim("|")} ${cmd("~/path")} ${dim("local directory")}`),
95
106
  "",
96
107
  h("Examples"),
97
- bullet(`${cmd("agentry add skills")} Prat011/awesome-llm-skills`),
98
- bullet(`${cmd("agentry add skills")} ./my-skills ${flag("--list")}`),
99
- bullet(`${cmd("agentry add skills")} ./my-skills enhance-prompt ${flag("-a")} cursor ${flag("-a")} claude-code`),
100
- bullet(`${cmd("agentry add agents")} author/repo frontend-developer`),
101
- bullet(`${cmd("agentry add profile")} frontend author/repo`),
108
+ bullet(`${cmd("agentry add skills")} mhmdreza-rafiei/agent-tools`),
109
+ bullet(`${cmd("agentry add skills")} mhmdreza-rafiei/agent-tools enhance-prompt ${flag("-a")} cursor`),
110
+ bullet(`${cmd("agentry list")}`),
111
+ bullet(`${cmd("agentry list skills")}`),
112
+ bullet(`${cmd("agentry list")} mhmdreza-rafiei/agent-tools`),
113
+ bullet(`${cmd("agentry list")} mhmdreza-rafiei/agent-tools skills`),
114
+ bullet(`${cmd("agentry list")} mhmdreza-rafiei/agent-tools skills enhance-prompt`),
102
115
  bullet(`${cmd("agentry remove skills")} enhance-prompt`),
116
+ bullet(`${cmd("agentry remove skills")} mhmdreza-rafiei/agent-tools`),
117
+ bullet(`${cmd("agentry update skills")} mhmdreza-rafiei/agent-tools`),
118
+ bullet(`${cmd("agentry init skill")} enhance-prompt prompt ${flag("--reference")}`),
119
+ bullet(`${cmd("agentry init profile")} frontend ${flag("--skills")} mhmdreza-rafiei/agent-tools`),
120
+ bullet(`${cmd("agentry init rule")} ask-dont-guess ${flag("--alwaysApply")}`),
103
121
  bullet(`${cmd("agentry update")}`),
104
- bullet(`${cmd("agentry update skills")} author/repo enhance-prompt`),
105
122
  "",
106
123
  h("Options"),
107
124
  ` ${flag("-g, --global")} ${dim("Install into ~ (all projects)")}`,
@@ -112,12 +129,21 @@ function printHelp() {
112
129
  ` ${flag("--copy")} ${dim("Copy files instead of symlinking")}`,
113
130
  ` ${flag("--all")} ${dim("Install everything to all agents, no prompts")}`,
114
131
  ` ${flag("-y, --yes")} ${dim("Don't prompt")}`,
132
+ ` ${flag("--description")} ${dim("<t>")} ${dim("init: frontmatter description")}`,
133
+ ` ${flag("--alwaysApply")} ${dim("init rule: alwaysApply: true")}`,
134
+ ` ${flag("--reference")} ${dim("init skill: add references/TEMPLATE.md")}`,
135
+ ` ${flag("--no-reference")} ${dim("init skill: skip references/")}`,
136
+ ` ${flag("--skills")} ${dim("[src]")} ${dim("init profile: include skills (optional source)")}`,
137
+ ` ${flag("--agents")} ${dim("[src]")} ${dim("init profile: include agents")}`,
138
+ ` ${flag("--rules")} ${dim("[src]")} ${dim("init profile: include rules")}`,
139
+ ` ${flag("--scripts")} ${dim("[src]")} ${dim("init profile: include scripts")}`,
115
140
  ` ${flag("-v, --version")} ${dim("Print version")}`,
116
141
  ` ${flag("-h, --help")} ${dim("Show this help")}`,
117
142
  "",
118
143
  dim("Tip: omit --agent to pick providers interactively (universal locked + searchable list)."),
144
+ dim("Tip: remove/update accept a GitHub repo or local path to filter by install source."),
119
145
  ""
120
146
  ];
121
147
  process.stdout.write(lines.join("\n"));
122
148
  }
123
- export { PALETTE, animateLogo, badge, delay, logo, printHelp, tagline, theme };
149
+ export { PALETTE, animateLogo, badge, delay, logo, printHelp, sky, tagline, theme };