ai-agent-skills 4.2.0 → 4.3.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/FOR_YOUR_AGENT.md +8 -0
- package/README.md +33 -8
- package/cli.js +624 -61
- package/docs/workflows/start-a-library.md +12 -2
- package/lib/catalog-data.cjs +23 -2
- package/lib/catalog-mutations.cjs +4 -2
- package/lib/catalog-paths.cjs +35 -0
- package/lib/workspace-import.cjs +396 -0
- package/package.json +1 -1
- package/skills/audit-library-health/SKILL.md +2 -2
- package/skills/build-workspace-docs/SKILL.md +1 -1
- package/skills.json +1577 -3
- package/tui/catalog.cjs +9 -5
- package/tui/index.mjs +59 -41
package/FOR_YOUR_AGENT.md
CHANGED
|
@@ -31,6 +31,8 @@ Do not hand-edit `skills.json`, `README.md`, or `WORK_AREAS.md` if the command a
|
|
|
31
31
|
Follow this curator decision protocol:
|
|
32
32
|
|
|
33
33
|
1. Create a new workspace with `npx ai-agent-skills init-library <name>`, unless I already gave you a library name.
|
|
34
|
+
- If I already have a flat repo of local skills, run `npx ai-agent-skills init-library . --import` from that repo root instead of creating a new directory.
|
|
35
|
+
- Invalid private-only names such as colon or underscore variants should be skipped and reported, not allowed to kill the whole batch.
|
|
34
36
|
2. Move into that workspace and keep working there.
|
|
35
37
|
3. Ask me at most 3 short questions before acting:
|
|
36
38
|
- what kinds of work the library needs to support
|
|
@@ -209,6 +211,12 @@ npx ai-agent-skills catalog conorluddy/ios-simulator-skill --skill ios-simulator
|
|
|
209
211
|
|
|
210
212
|
npx ai-agent-skills build-docs
|
|
211
213
|
|
|
214
|
+
# Existing flat repo of skills
|
|
215
|
+
cd ~/projects/my-skills
|
|
216
|
+
npx ai-agent-skills init-library . --areas "mobile,workflow,agent-engineering" --import --auto-classify
|
|
217
|
+
npx ai-agent-skills list --area workflow
|
|
218
|
+
npx ai-agent-skills curate my-skill --area mobile --branch "Mobile / Imported" --why "Why it belongs."
|
|
219
|
+
|
|
212
220
|
git init
|
|
213
221
|
git add .
|
|
214
222
|
git commit -m "Initialize skills library"
|
package/README.md
CHANGED
|
@@ -13,10 +13,10 @@
|
|
|
13
13
|
<a href="https://github.com/MoizIbnYousaf/Ai-Agent-Skills"><img alt="GitHub stars" src="https://img.shields.io/github/stars/MoizIbnYousaf/Ai-Agent-Skills?style=for-the-badge&label=stars&labelColor=313244&color=89b4fa&logo=github&logoColor=cdd6f4" /></a>
|
|
14
14
|
<a href="https://www.npmjs.com/package/ai-agent-skills"><img alt="npm version" src="https://img.shields.io/npm/v/ai-agent-skills?style=for-the-badge&label=version&labelColor=313244&color=b4befe&logo=npm&logoColor=cdd6f4" /></a>
|
|
15
15
|
<a href="https://www.npmjs.com/package/ai-agent-skills"><img alt="npm total downloads" src="https://img.shields.io/npm/dt/ai-agent-skills?style=for-the-badge&label=downloads&labelColor=313244&color=f5e0dc&logo=npm&logoColor=cdd6f4" /></a>
|
|
16
|
-
<a href="https://github.com/MoizIbnYousaf/Ai-Agent-Skills#shelves"><img alt="Library structure" src="https://img.shields.io/badge/library-
|
|
16
|
+
<a href="https://github.com/MoizIbnYousaf/Ai-Agent-Skills#shelves"><img alt="Library structure" src="https://img.shields.io/badge/library-115%20skills%20%C2%B7%206%20shelves-cba6f7?style=for-the-badge&labelColor=313244&logo=bookstack&logoColor=cdd6f4" /></a>
|
|
17
17
|
</p>
|
|
18
18
|
|
|
19
|
-
<p align="center"><sub>17 house copies ·
|
|
19
|
+
<p align="center"><sub>17 house copies · 98 cataloged upstream</sub></p>
|
|
20
20
|
<!-- GENERATED:library-stats:end -->
|
|
21
21
|
|
|
22
22
|
<p align="center"><em>Picked, shelved, and maintained by hand.</em></p>
|
|
@@ -44,13 +44,12 @@ The bundled library is organized the way I work:
|
|
|
44
44
|
Use `skills.sh` for the broad ecosystem.
|
|
45
45
|
Use `ai-agent-skills` when you want a smaller library with shelves, provenance, and notes.
|
|
46
46
|
|
|
47
|
-
## What's New in 4.
|
|
47
|
+
## What's New in 4.3.1
|
|
48
48
|
|
|
49
|
-
-
|
|
50
|
-
-
|
|
51
|
-
-
|
|
52
|
-
-
|
|
53
|
-
- Installed status in both the CLI and TUI
|
|
49
|
+
- Marketing pack synced to `marketing-cli@0.5.4` — 51 skills total, with `mktg-setup`, `postiz`, `mktg-x`, `firecrawl`, and `summarize` newly added to the `mktg` collection
|
|
50
|
+
- Renamed the upstream marketing pack source from `MoizIbnYousaf/mktg` to `MoizIbnYousaf/marketing-cli` across catalog metadata, install sources, and source URLs
|
|
51
|
+
- Bundled library now ships 115 cataloged skills (17 house copies, 98 cataloged upstream)
|
|
52
|
+
- Same private-library bootstrap, bulk import, and managed-workspace flow shipped in `4.3.0`
|
|
54
53
|
|
|
55
54
|
## What It Is Now
|
|
56
55
|
|
|
@@ -135,6 +134,10 @@ npx ai-agent-skills swift
|
|
|
135
134
|
# Install an entire curated pack
|
|
136
135
|
npx ai-agent-skills install --collection swift-agent-skills -p
|
|
137
136
|
|
|
137
|
+
# Install the mktg marketing pack
|
|
138
|
+
npx ai-agent-skills mktg
|
|
139
|
+
npx ai-agent-skills marketing-cli
|
|
140
|
+
|
|
138
141
|
# Install to the project shelf
|
|
139
142
|
npx ai-agent-skills install pdf -p
|
|
140
143
|
|
|
@@ -165,6 +168,14 @@ npx ai-agent-skills install frontend-design -p
|
|
|
165
168
|
npx ai-agent-skills sync frontend-design -p
|
|
166
169
|
npx ai-agent-skills add anthropics/skills --skill webapp-testing --area workflow --branch Testing --why "I use this when I want browser-level checks in the workspace."
|
|
167
170
|
npx ai-agent-skills build-docs
|
|
171
|
+
|
|
172
|
+
# Or bootstrap an existing flat repo of skills in place
|
|
173
|
+
cd ~/projects/my-skills
|
|
174
|
+
npx ai-agent-skills init-library . --areas "mobile,workflow,agent-engineering" --import --auto-classify
|
|
175
|
+
npx ai-agent-skills browse
|
|
176
|
+
|
|
177
|
+
# Invalid private-only names are skipped and reported.
|
|
178
|
+
# Low-confidence imports fall back to workflow with a needs-curation label.
|
|
168
179
|
```
|
|
169
180
|
|
|
170
181
|
## Workspace Mode
|
|
@@ -182,6 +193,13 @@ npx ai-agent-skills install frontend-design -p
|
|
|
182
193
|
npx ai-agent-skills add anthropics/skills --skill webapp-testing --area workflow --branch Testing --why "I use this when I want browser-level checks in the workspace."
|
|
183
194
|
npx ai-agent-skills sync frontend-design -p
|
|
184
195
|
npx ai-agent-skills build-docs
|
|
196
|
+
|
|
197
|
+
# Bulk import an existing library after bootstrap
|
|
198
|
+
npx ai-agent-skills import --auto-classify
|
|
199
|
+
|
|
200
|
+
# Review the fallback bucket and fix shelf placement
|
|
201
|
+
npx ai-agent-skills list --area workflow
|
|
202
|
+
npx ai-agent-skills curate some-skill --area mobile --branch "Mobile / Testing" --why "Why it belongs."
|
|
185
203
|
```
|
|
186
204
|
|
|
187
205
|
Workflow guides:
|
|
@@ -220,6 +238,7 @@ The shelves are the main structure.
|
|
|
220
238
|
| Mobile | 24 | Swift, SwiftUI, iOS, and Apple-platform development, with room for future React Native branches. |
|
|
221
239
|
| Workflow | 11 | Files, docs, planning, release work, and research-to-output flows. |
|
|
222
240
|
| Agent Engineering | 14 | MCP, skill-building, prompting discipline, and LLM application work. |
|
|
241
|
+
| Marketing | 51 | Brand, strategy, copy, distribution, creative, SEO, conversion, and growth work. |
|
|
223
242
|
<!-- GENERATED:shelf-table:end -->
|
|
224
243
|
|
|
225
244
|
The full map lives in [WORK_AREAS.md](./WORK_AREAS.md).
|
|
@@ -237,6 +256,7 @@ Collections are smaller sets. Useful, but secondary to the shelves.
|
|
|
237
256
|
| `build-systems` | Backend, architecture, MCP, and security work. | `mcp-builder`, `backend-development`, `database-design` |
|
|
238
257
|
| `test-and-debug` | QA, debugging, CI cleanup, and observability. | `playwright`, `webapp-testing`, `gh-fix-ci` |
|
|
239
258
|
| `docs-and-research` | Docs, files, research, and writing work. | `pdf`, `doc-coauthoring`, `docx` |
|
|
259
|
+
| `mktg` | The full upstream marketing-cli playbook. Install the whole set at once or pick from it. | `cmo`, `brand-voice`, `positioning-angles` |
|
|
240
260
|
<!-- GENERATED:collection-table:end -->
|
|
241
261
|
|
|
242
262
|
## Curating the catalog
|
|
@@ -286,6 +306,7 @@ Current upstream mix:
|
|
|
286
306
|
<!-- GENERATED:source-table:start -->
|
|
287
307
|
| Source repo | Skills |
|
|
288
308
|
| --- | --- |
|
|
309
|
+
| `MoizIbnYousaf/marketing-cli` | 51 |
|
|
289
310
|
| `anthropics/skills` | 11 |
|
|
290
311
|
| `MoizIbnYousaf/Ai-Agent-Skills` | 11 |
|
|
291
312
|
| `openai/skills` | 9 |
|
|
@@ -334,8 +355,11 @@ npx ai-agent-skills preview pdf
|
|
|
334
355
|
# Install
|
|
335
356
|
npx ai-agent-skills install <skill-name>
|
|
336
357
|
npx ai-agent-skills swift
|
|
358
|
+
npx ai-agent-skills mktg
|
|
359
|
+
npx ai-agent-skills marketing-cli
|
|
337
360
|
npx ai-agent-skills install <skill-name> -p
|
|
338
361
|
npx ai-agent-skills install --collection swift-agent-skills -p
|
|
362
|
+
npx ai-agent-skills install --collection mktg -p
|
|
339
363
|
npx ai-agent-skills <owner/repo>
|
|
340
364
|
npx ai-agent-skills install <owner/repo>
|
|
341
365
|
npx ai-agent-skills install <owner/repo>@<skill-name>
|
|
@@ -357,6 +381,7 @@ npx ai-agent-skills catalog <owner/repo> --skill <name> --area <shelf> --branch
|
|
|
357
381
|
npx ai-agent-skills curate <skill-name> --branch "<branch>"
|
|
358
382
|
npx ai-agent-skills curate review
|
|
359
383
|
npx ai-agent-skills vendor <repo-or-path> --skill <name> --area <shelf> --branch <branch> --why "<editorial note>"
|
|
384
|
+
npx ai-agent-skills import [path] --auto-classify
|
|
360
385
|
```
|
|
361
386
|
|
|
362
387
|
## Testing
|