@neta-art/neta-search-cli 0.2.16 → 0.2.20

package/README.md

@@ -3,21 +3,25 @@
 Command-line client for **neta-search**, the skill registry of the Cohub / Neta platform: search the ecosystem for a ready-made skill, try it without installing, or install it into your space.
 
 ```bash
-npx -y @neta-art/neta-search-cli@0.2 skills find "generate video"     # search (Chinese or English)
-npx -y @neta-art/neta-search-cli@0.2 skills find "browser automation" --json
-npx -y @neta-art/neta-search-cli@0.2 skills use  <id>                 # print the SKILL.md (pulled into a temp dir; no project files written)
-npx -y @neta-art/neta-search-cli@0.2 skills add  <id>                 # install into .agents/skills/
-npx -y @neta-art/neta-search-cli@0.2 skills list                      # what's in .agents/skills/, and which installed ones have updates
-npx -y @neta-art/neta-search-cli@0.2 skills update                    # update installed skills to their current release
-npx -y @neta-art/neta-search-cli@0.2 skills init <name>               # scaffold your own skill
+npx -y @neta-art/neta-search-cli@latest skills find "generate video"     # search (Chinese or English)
+npx -y @neta-art/neta-search-cli@latest skills find "browser automation" --json
+npx -y @neta-art/neta-search-cli@latest skills use  <id>                 # print the SKILL.md (pulled into a temp dir; no project files written)
+npx -y @neta-art/neta-search-cli@latest skills add  <id>                 # install into .agents/skills/
+npx -y @neta-art/neta-search-cli@latest skills list                      # what's in .agents/skills/, and which installed ones have updates
+npx -y @neta-art/neta-search-cli@latest skills update                    # update installed skills to their current release (or name some: handle, id or directory)
+npx -y @neta-art/neta-search-cli@latest skills init <name>               # scaffold your own skill
 ```
 
-`<id>` comes from `find` results, e.g. `cohub:<spaceId>/<name>`; a handle such as `neta-skills/holo-pack-opening` works too.
+`<id>` is what `find` prints: a handle such as `neta-skills/holo-pack-opening` or `cohub/agent-browser`. Skills without a handle are listed as `cohub:<spaceId>/<name>`, which works everywhere a handle does. `update` and `remove` also accept the directory name under `.agents/skills/`.
 
-`skills remove <name>` deletes an installed skill from `.agents/skills/`. Skills you wrote yourself (no install record) are left alone unless you pass `--force`.
+`remove` deletes installed skills only. Skills you wrote yourself (no install record) are left alone unless you pass `--force`.
 
 `use` prints the skill directory and the full SKILL.md, so an agent can follow it right away; relative paths in SKILL.md resolve against that directory. If the local entry is a pointer (frontmatter `metadata.neta-skill-id`), `use` fetches the full skill it points to.
 
+Each `find --json` item carries a ready-to-run `use` command (`skills use <id> --via find`); prefix it with `npx -y @neta-art/neta-search-cli@latest` or `neta-search`. `--via` only labels where the use came from in usage stats.
+
+Use `@latest` (or an exact version): with a range such as `@0.2`, npx keeps running whatever matching version it cached earlier and never checks for a newer one.
+
 Inside a Cohub sandbox the CLI picks up the sandbox identity automatically; elsewhere it runs anonymously.
 
 Single file, no runtime dependencies. Node.js 20+.