yourskills 0.1.2 → 0.1.4

package/README.md

@@ -6,7 +6,8 @@ Install the agent skills and bundles your team publishes, from the terminal.
 commit your registry pins. The registry never sends skill files: they are fetched from
 your own git host with your own credentials, so a private skill stays private.
 
-Documentation lives at **[yourskills.store](https://yourskills.store)**.
+Documentation lives at **[yourskills.store](https://yourskills.store)**. The package is
+**[npmjs.com/package/yourskills](https://www.npmjs.com/package/yourskills)**.
 
 ## Install
 
@@ -27,34 +28,54 @@ yourskills login
 ## Use
 
 ```bash
-yourskills                      # the command palette, if you would rather not memorise
+yourskills                      # opens the command palette, if you would rather not memorise
 yourskills search pull request  # find something
-yourskills bundle backend-dev   # install a bundle at its pinned commits
+yourskills bundles              # the bundles your team publishes
+yourskills add backend-dev      # install a bundle at its pinned commits
 yourskills add create-pr        # or one skill
 ```
 
+One verb for both. A name is a skill or a bundle and your registry knows which, so you
+only have to know what you want. `bundle:<name>` and `skill:<name>` force the kind, which
+is worth typing in a script and nowhere else. `yourskills bundle <name>` is the old
+spelling of `add <name>` and still works.
+
 Installs are **global by default**, for every agent you have. Add `-p` to install into the
 current project instead, which records them in a `yourskills.json` you commit. A teammate
 who clones that repository runs `yourskills install` and gets the same skills at the same
 commits.
 
 ```bash
-yourskills installed   # what is on this machine, and at which commit
-yourskills outdated    # what your registry has moved on from
-yourskills update      # catch up
-yourskills remove <skill>
-yourskills doctor      # when something is wrong and you want to know what
+yourskills installed      # what is on this machine, and at which commit
+yourskills outdated       # what your registry has moved on from
+yourskills update         # catch up
+yourskills remove <name>  # a skill, or a bundle and every skill it brought in
+yourskills doctor         # when something is wrong and you want to know what
 ```
 
 ## Hooks
 
-`yourskills hooks install` registers a session-start check with your agent, so it can tell
-you when an installed skill has moved. It never writes skill files on its own.
+The session-start hook registers itself, once per machine, at the end of your first login,
+and prints where it wrote and how to undo it. You do not run `yourskills hooks install`
+for it. Once a day, at the start of a session, it installs any
+skill your registry has moved on to and tells you what it changed:
+
+```
+yourskills: updated 2 skills to the ref your registry pins
+  create-pr    a1b2c3d -> e4f5a6b
+  review-code  9876543 -> 1234567
+```
+
+It only touches skills already in your manifest, only moves them to the commit your own
+registry pins, and says so every time. `yourskills config set autoUpdate false` keeps the
+check and stops the installing.
+
+Usage counting is a separate hook and never registers itself. It is **opt in**, with
+`yourskills hooks install --track`. When it is on, an invocation sends the skill's registry
+id, the commit you installed it at, which agent ran it, and when. The CLI never sends a
+user identifier. `YOURSKILLS_NO_TRACK=1` turns it off outright.
 
-Usage counting is separate and **opt in**, with `yourskills hooks install --track`. When it
-is on, an invocation sends the skill's registry id, the commit you installed it at, which
-agent ran it, and when. The CLI never sends a user identifier. `YOURSKILLS_NO_TRACK=1`
-turns it off outright, and `yourskills hooks uninstall` removes what we registered and
-nothing else.
+`yourskills hooks status` shows what is registered and where. `yourskills hooks uninstall`
+removes what we registered and nothing else.
 
 Run `yourskills --help` for the full command list.