skillcask 0.8.0 → 0.9.1

package/README.md

@@ -161,6 +161,9 @@ follow `config.toml`.
 # ~/.config/skillcask/config.toml
 [agents]
 targets = ["claude", "kiro"]
+
+[search]
+skills-sh = true   # search also asks skills.sh (it receives the query); written by search --remember
 ```
 
 When a target is dropped, the next `install` removes the links skillcask made there; `doctor`
@@ -271,7 +274,7 @@ skillcask -g install --frozen    # e.g. from a dotfiles repository
 
 ### Commands
 
-Every command except `publish` and `validate` takes `-g, --global`.
+Every command except `publish`, `validate` and `projects` takes `-g, --global`.
 
 | Command | |
 |---|---|
@@ -285,18 +288,23 @@ Every command except `publish` and `validate` takes `-g, --global`.
 | `outdated [--strict]` | Newer versions, when cooled-down ones become eligible, and GitHub or git tags moved since they were locked. `--strict` exits 1 when `update` would lock a newer version. |
 | `diff [vendor/name] [--to constraint\|--from old.lock]` | Unified diff of skill files from the locked version to the one `update` would lock, or from an older lock to `skills.lock`, see below. |
 | `info <vendor/name[@constraint]\|github:owner/repo\|git:url\|skill>` | A package's skills, versions, description, license and requirements, or which package installs a skill. |
-| `status` | Exit 1 when manifest, lock or installed files disagree. |
+| `status` | Exit 1 when manifest, lock or installed files disagree. Also lists the repositories in use (name, type, URL without credentials) and whether `allow-sources` admits each. |
 | `doctor [--fix]` | Broken or committed links, stale gitignore block, modified skills; lists each check it ran. |
 | `audit [--json\|--sarif]` | What each installed skill reaches (commands, hosts, paths, env vars, scripts) and its findings: modified files, risky lines, invisible characters. Exit 1 on any finding. |
-| `search <query>` | Packagist (`type=ai-agent-skill`) and skill packages of the other repositories, GitLab included. |
+| `search <query> [--skills-sh\|--no-skills-sh [--remember]]` | Packagist (`type=ai-agent-skill`) and skill packages of the other repositories, GitLab included; with skills.sh on, also the GitHub skills it lists, as `github:owner/repo/skill` with their install count. skills.sh is off until you turn it on, since it receives the query: the first search in a terminal asks once, `--remember` saves a flag's choice, both in `config.toml`. |
 | `auth set\|remove <host>` | Keep a registry token in git's credential helper (Keychain, Credential Manager, libsecret). |
 | `publish --vendor v --base-url URL --out DIR [--inline] [--dist-url TPL] [paths…]` | Build a static Composer repository from a monorepo. |
 | `validate [paths…]` | Check `SKILL.md` files against the Agent Skills spec, see below. |
+| `projects [dirs…]` | Directories that hold `skills.toml` under the given ones (default: the current one), up to 6 levels down; hidden directories, `node_modules`, `vendor`, `target` and `Library` are skipped. |
+| `ui` | A terminal UI over the commands above: skills with their state and updates, `info`, SKILL.md and `audit` per skill, add, adopt, update (diff first), remove, doctor, a filter of the list, search of the registries (and skills.sh, asked once), the repositories in use (`R`) and a projects picker; `g` switches between the project and `--global`. |
 | `<other>` | Runs `skillcask-<other>` from `PATH`, like git and cargo plugins. |
 
-`status`, `outdated`, `info`, `search`, `doctor` and `audit` take `--json`: one JSON document on one line of
+`status`, `outdated`, `info`, `search`, `doctor`, `audit` and `projects` take `--json`: one JSON document on one line of
 stdout, with the same exit code; warnings and errors stay on stderr. Package text in it is
-escaped as in the terminal (`<U+202E>`). For example `skillcask outdated --json | jq
+escaped as in the terminal (`<U+202E>`). `status --json` has `repositories`
+(`[{"name", "type", "url", "allowed"}]`); `search --json` results carry `source` (the repository
+name, or `skills.sh`) and `installs`, and the document has `"skills-sh": true|false|null` (`null`:
+never decided). For example `skillcask outdated --json | jq
 '.packages[] | select(.within != .locked)'`.
 
 Exit codes: 0 ok, 1 manifest/lock/status problems, 2 authentication, 3 network, 4 hash mismatch,
@@ -396,7 +404,10 @@ GitHub allows 60 anonymous API requests per hour. `add`, `update` and `outdated`
 entry; `install` from the lock uses none, it downloads the pinned archive. Set `GITHUB_TOKEN`
 (GitHub Actions has one) or Composer's `"github-oauth": {"github.com": "<token>"}` in `auth.json`
 for a higher limit and for private repositories. `SKILLCASK_GITHUB_API` points at GitHub
-Enterprise (`https://ghe.example.com/api/v3`).
+Enterprise (`https://ghe.example.com/api/v3`). `GITHUB_TOKEN` is sent only to the API the user or
+the runner names: `SKILLCASK_GITHUB_API`, else GitHub Actions' `GITHUB_API_URL`, else
+`api.github.com`; for an Enterprise URL set only in `skills.toml`, use
+`skillcask auth set ghe.example.com --username oauth2` or `github-oauth` in `auth.json`.
 
 skills.sh itself is not queried: its API is undocumented and may change without notice. Search
 on the website, then add what you picked.

package/npm-shrinkwrap.json

@@ -19,7 +19,7 @@
       "hasInstallScript": true,
       "license": "MIT OR Apache-2.0",
       "name": "skillcask",
-      "version": "0.8.0"
+      "version": "0.9.1"
     },
     "node_modules/detect-libc": {
       "engines": {
@@ -48,5 +48,5 @@
     }
   },
   "requires": true,
-  "version": "0.8.0"
+  "version": "0.9.1"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "artifactDownloadUrls": [
-    "https://github.com/puniserv/skillcask/releases/download/v0.8.0"
+    "https://github.com/puniserv/skillcask/releases/download/v0.9.1"
   ],
   "bin": {
     "skillcask": "run-skillcask.js"
@@ -104,7 +104,7 @@
       "zipExt": ".tar.xz"
     }
   },
-  "version": "0.8.0",
+  "version": "0.9.1",
   "volta": {
     "node": "18.14.1",
     "npm": "9.5.0"