skilld 1.6.2 → 1.7.0

package/README.md

@@ -51,7 +51,7 @@ __Requires Node 22.6.0 or higher.__
 Or add a specific package directly:
 
 ```bash
-npx -y skilld add vue
+npx -y skilld add npm:vue
 ```
 
 If you need to re-configure skilld, just run `npx -y skilld config` to update your agent, model, or preferences.
@@ -59,10 +59,10 @@ If you need to re-configure skilld, just run `npx -y skilld config` to update yo
 **No agent CLI?** No problem - choose "No agent" when prompted. You get a base skill immediately, plus portable prompts you can run in any LLM:
 
 ```bash
-npx -y skilld add vue
+npx -y skilld add npm:vue
 # Choose "No agent" -> base skill + prompts exported
 # Paste prompts into ChatGPT/Claude web, save outputs, then:
-npx -y skilld assemble
+npx -y skilld author assemble
 ```
 
 ### Tips
@@ -143,8 +143,14 @@ Yes. Add `skilld prepare` to your prepare script. It restores references, auto-i
 # Interactive mode - auto-discover from package.json
 skilld
 
-# Add skills for specific package(s)
-skilld add vue nuxt pinia
+# Add skills for specific package(s) — npm: prefix for registry packages
+skilld add npm:vue npm:nuxt npm:pinia
+
+# Add a pre-authored skill from a GitHub repo
+skilld add gh:vercel-labs/agent-skills
+
+# Add a skill for a Rust crate (crates.io)
+skilld add crate:serde
 
 # Update outdated skills
 skilld update
@@ -156,13 +162,13 @@ skilld search "error" -p nuxt --filter '{"type":"issue"}'
 skilld search --guide -p nuxt
 
 # Target a specific agent
-skilld add react --agent cursor
+skilld add npm:react --agent cursor
 
 # Install globally to ~/.claude/skills
-skilld add zod --global
+skilld add npm:zod --global
 
 # Skip prompts
-skilld add drizzle-orm --yes
+skilld add npm:drizzle-orm --yes
 
 # Check skill info
 skilld info
@@ -180,8 +186,8 @@ skilld config
 | Command | Description |
 |---------|-------------|
 | `skilld` | Interactive wizard (first run) or status menu (existing skills) |
-| `skilld add <pkg...>` | Add skills for package(s), space or comma-separated |
-| `skilld update [pkg]` | Update outdated skills (all or specific) |
+| `skilld add <source...>` | Add skills. Sources: `npm:<pkg>`, `crate:<name>`, `gh:<owner/repo>`, or bare names (deprecated) |
+| `skilld update [pkg]`   | Update outdated skills (all or specific) |
 | `skilld search [query]` | Search indexed docs (`-p` package, `--filter` JSON, `--limit`, `--guide`) |
 | `skilld list`           | List installed skills (`--json` for machine-readable output) |
 | `skilld info`           | Show skill info and config |
@@ -190,15 +196,18 @@ skilld config
 | `skilld remove`         | Remove installed skills |
 | `skilld uninstall`      | Remove all skilld data |
 | `skilld cache`          | Cache management (clean expired LLM cache entries) |
-| `skilld eject <pkg>`    | Eject skill as portable directory (no symlinks) |
-| `skilld assemble [dir]` | Merge LLM output files back into SKILL.md (auto-discovers) |
+| `skilld author package <pkg>`  | Generate a portable package skill from docs |
+| `skilld author publish` | Publish skills to skilld.dev |
+| `skilld author eject <pkg>`    | Eject skill as portable directory (no symlinks) |
+| `skilld author validate <file>`| Validate a skill section |
+| `skilld author assemble [dir]` | Merge LLM output files back into SKILL.md (auto-discovers) |
 
 ### Works Without an Agent CLI
 
 No Claude, Gemini, or Codex CLI? Choose "No agent" when prompted. You get a base skill immediately, plus portable prompts you can run in any LLM to enhance it:
 
 ```bash
-skilld add vue
+skilld add npm:vue
 # Choose "No agent" -> installs to .claude/skills/vue-skilld/
 
 # What you get:
@@ -208,23 +217,23 @@ skilld add vue
 
 # Run each PROMPT_*.md in ChatGPT/Claude web/any LLM
 # Save outputs as _BEST_PRACTICES.md, _API_CHANGES.md, then:
-skilld assemble
+skilld author assemble
 ```
 
-`skilld assemble` auto-discovers skills with pending output files. `skilld update` re-exports prompts for outdated packages.
+`skilld author assemble` auto-discovers skills with pending output files. `skilld update` re-exports prompts for outdated packages.
 
 ### Eject
 
 Export a skill as a portable, self-contained directory for sharing via git repos:
 
 ```bash
-skilld eject vue                    # Default skill directory
-skilld eject vue --name vue         # Custom directory name
-skilld eject vue --out ./skills/    # Custom path
-skilld eject vue --from 2025-07-01  # Only recent releases/issues
+skilld author eject vue                    # Default skill directory
+skilld author eject vue --name vue         # Custom directory name
+skilld author eject vue --out ./skills/    # Custom path
+skilld author eject vue --from 2025-07-01  # Only recent releases/issues
 ```
 
-Share via `skilld add owner/repo` - consumers get fully functional skills with no LLM cost.
+Share via `skilld add gh:owner/repo` - consumers get fully functional skills with no LLM cost.
 
 ### CLI Options
 

package/dist/_chunks/agent.mjs

@@ -3,7 +3,8 @@ import { n as sanitizeMarkdown } from "./sanitize.mjs";
 import { h as writeSections, m as readCachedSection } from "./cache.mjs";
 import { i as resolveSkilldCommand } from "./shared.mjs";
 import { a as targets, t as detectInstalledAgents } from "./detect.mjs";
-import { c as SECTION_OUTPUT_FILES, f as getSectionValidator, l as buildAllSectionPrompts, m as wrapSection, s as SECTION_MERGE_ORDER } from "./prompts.mjs";
+import { i as buildAllSectionPrompts, l as wrapSection, n as SECTION_MERGE_ORDER, r as SECTION_OUTPUT_FILES, s as getSectionValidator } from "./prompts.mjs";
+import "./install.mjs";
 import { t as Type } from "./libs/@sinclair/typebox.mjs";
 import { homedir } from "node:os";
 import { dirname, join } from "pathe";