ai-agent-skills 4.2.0 → 4.3.0

package/FOR_YOUR_AGENT.md

@@ -31,6 +31,8 @@ Do not hand-edit `skills.json`, `README.md`, or `WORK_AREAS.md` if the command a
 Follow this curator decision protocol:
 
 1. Create a new workspace with `npx ai-agent-skills init-library <name>`, unless I already gave you a library name.
+   - 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.
+   - Invalid private-only names such as colon or underscore variants should be skipped and reported, not allowed to kill the whole batch.
 2. Move into that workspace and keep working there.
 3. Ask me at most 3 short questions before acting:
    - 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
 
 npx ai-agent-skills build-docs
 
+# Existing flat repo of skills
+cd ~/projects/my-skills
+npx ai-agent-skills init-library . --areas "mobile,workflow,agent-engineering" --import --auto-classify
+npx ai-agent-skills list --area workflow
+npx ai-agent-skills curate my-skill --area mobile --branch "Mobile / Imported" --why "Why it belongs."
+
 git init
 git add .
 git commit -m "Initialize skills library"

package/README.md

@@ -13,10 +13,10 @@
   <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>
   <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>
   <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>
-  <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>
+  <a href="https://github.com/MoizIbnYousaf/Ai-Agent-Skills#shelves"><img alt="Library structure" src="https://img.shields.io/badge/library-110%20skills%20%C2%B7%206%20shelves-cba6f7?style=for-the-badge&labelColor=313244&logo=bookstack&logoColor=cdd6f4" /></a>
 </p>
 
-<p align="center"><sub>17 house copies · 47 cataloged upstream</sub></p>
+<p align="center"><sub>17 house copies · 93 cataloged upstream</sub></p>
 <!-- GENERATED:library-stats:end -->
 
 <p align="center"><em>Picked, shelved, and maintained by hand.</em></p>
@@ -44,13 +44,13 @@ The bundled library is organized the way I work:
 Use `skills.sh` for the broad ecosystem.
 Use `ai-agent-skills` when you want a smaller library with shelves, provenance, and notes.
 
-## What's New in 4.0.0
+## What's New in 4.2.0
 
-- Managed library workspaces with `init-library`
-- `add <source>` for bringing bundled picks, upstream repo skills, or house copies into your own library
-- `sync [name]` as the main refresh command; `update` stays as an alias
-- Dependency-aware installs with `requires` and `--no-deps`
-- Installed status in both the CLI and TUI
+- Managed team libraries you can share over GitHub and install with `install <owner>/<repo>`
+- Machine-readable CLI flows with `--format json`, `--fields`, pagination, and safer non-interactive output
+- More authored workflow skills for curating, reviewing, syncing, and sharing libraries
+- Dependency-aware installs, `sync` as the main refresh verb, and stronger installed-state visibility across the CLI and TUI
+- A cleaner curator loop around shelves, provenance, trust, and shared starter packs
 
 ## What It Is Now
 
@@ -135,6 +135,10 @@ npx ai-agent-skills swift
 # Install an entire curated pack
 npx ai-agent-skills install --collection swift-agent-skills -p
 
+# Install the mktg marketing pack
+npx ai-agent-skills mktg
+npx ai-agent-skills marketing-cli
+
 # Install to the project shelf
 npx ai-agent-skills install pdf -p
 
@@ -165,6 +169,14 @@ npx ai-agent-skills install frontend-design -p
 npx ai-agent-skills sync frontend-design -p
 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."
 npx ai-agent-skills build-docs
+
+# Or bootstrap an existing flat repo of skills in place
+cd ~/projects/my-skills
+npx ai-agent-skills init-library . --areas "mobile,workflow,agent-engineering" --import --auto-classify
+npx ai-agent-skills browse
+
+# Invalid private-only names are skipped and reported.
+# Low-confidence imports fall back to workflow with a needs-curation label.
 ```
 
 ## Workspace Mode
@@ -182,6 +194,13 @@ npx ai-agent-skills install frontend-design -p
 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."
 npx ai-agent-skills sync frontend-design -p
 npx ai-agent-skills build-docs
+
+# Bulk import an existing library after bootstrap
+npx ai-agent-skills import --auto-classify
+
+# Review the fallback bucket and fix shelf placement
+npx ai-agent-skills list --area workflow
+npx ai-agent-skills curate some-skill --area mobile --branch "Mobile / Testing" --why "Why it belongs."
 ```
 
 Workflow guides:
@@ -220,6 +239,7 @@ The shelves are the main structure.
 | Mobile | 24 | Swift, SwiftUI, iOS, and Apple-platform development, with room for future React Native branches. |
 | Workflow | 11 | Files, docs, planning, release work, and research-to-output flows. |
 | Agent Engineering | 14 | MCP, skill-building, prompting discipline, and LLM application work. |
+| Marketing | 46 | Brand, strategy, copy, distribution, creative, SEO, conversion, and growth work. |
 <!-- GENERATED:shelf-table:end -->
 
 The full map lives in [WORK_AREAS.md](./WORK_AREAS.md).
@@ -237,6 +257,7 @@ Collections are smaller sets. Useful, but secondary to the shelves.
 | `build-systems` | Backend, architecture, MCP, and security work. | `mcp-builder`, `backend-development`, `database-design` |
 | `test-and-debug` | QA, debugging, CI cleanup, and observability. | `playwright`, `webapp-testing`, `gh-fix-ci` |
 | `docs-and-research` | Docs, files, research, and writing work. | `pdf`, `doc-coauthoring`, `docx` |
+| `mktg` | The full upstream mktg marketing playbook. Install the whole set at once or pick from it. | `cmo`, `brand-voice`, `positioning-angles` |
 <!-- GENERATED:collection-table:end -->
 
 ## Curating the catalog
@@ -286,6 +307,7 @@ Current upstream mix:
 <!-- GENERATED:source-table:start -->
 | Source repo | Skills |
 | --- | --- |
+| `MoizIbnYousaf/mktg` | 46 |
 | `anthropics/skills` | 11 |
 | `MoizIbnYousaf/Ai-Agent-Skills` | 11 |
 | `openai/skills` | 9 |
@@ -334,8 +356,11 @@ npx ai-agent-skills preview pdf
 # Install
 npx ai-agent-skills install <skill-name>
 npx ai-agent-skills swift
+npx ai-agent-skills mktg
+npx ai-agent-skills marketing-cli
 npx ai-agent-skills install <skill-name> -p
 npx ai-agent-skills install --collection swift-agent-skills -p
+npx ai-agent-skills install --collection mktg -p
 npx ai-agent-skills <owner/repo>
 npx ai-agent-skills install <owner/repo>
 npx ai-agent-skills install <owner/repo>@<skill-name>
@@ -357,6 +382,7 @@ npx ai-agent-skills catalog <owner/repo> --skill <name> --area <shelf> --branch
 npx ai-agent-skills curate <skill-name> --branch "<branch>"
 npx ai-agent-skills curate review
 npx ai-agent-skills vendor <repo-or-path> --skill <name> --area <shelf> --branch <branch> --why "<editorial note>"
+npx ai-agent-skills import [path] --auto-classify
 ```
 
 ## Testing