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 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-64%20skills%20%C2%B7%205%20shelves-cba6f7?style=for-the-badge&labelColor=313244&logo=bookstack&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-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 · 47 cataloged upstream</sub></p>
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.0.0
47
+ ## What's New in 4.3.1
48
48
 
49
- - Managed library workspaces with `init-library`
50
- - `add <source>` for bringing bundled picks, upstream repo skills, or house copies into your own library
51
- - `sync [name]` as the main refresh command; `update` stays as an alias
52
- - Dependency-aware installs with `requires` and `--no-deps`
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