@xelandernt/skilly 0.0.25 → 0.0.26

package/README.md

@@ -1,3 +1,9 @@
+[![npm](https://img.shields.io/npm/v/%40xelandernt%2Fskilly
+)](https://www.npmjs.com/package/@xelandernt/skilly)
+[![pyrefly](https://img.shields.io/endpoint?url=https://pyrefly.org/badge.json)](https://github.com/facebook/pyrefly)
+[![GitHub stars](https://img.shields.io/github/stars/xelandernt/skilly)](https://github.com/xelandernt/skilly/stargazers)
+[![PyPI Downloads](https://static.pepy.tech/badge/skilly/month)](https://pepy.tech/projects/skilly)
+[![Supported versions](https://img.shields.io/pypi/pyversions/skilly.svg)](https://pypi.python.org/pypi/skilly)
 # skilly
 
 Manage [Agent Skills](https://agentskills.io/specification) from the command line
@@ -8,14 +14,26 @@ Python dependencies, and keeps managed skills up to date.
 
 ## Installation
 
-Run the CLI without installing it:
-
+Run with `uvx`:
 ```shell
 uvx skilly --help
+
+```
+
+Run with `npx`:
+```shell
 npx @xelandernt/skilly --help
 ```
 
-Or install the CLI and Python package:
+Install the native CLI with Homebrew from this repository's tap:
+
+```shell
+brew tap xelandernt/skilly https://github.com/xelandernt/skilly
+brew install xelandernt/skilly/skilly
+```
+
+Homebrew installs the CLI only. Install the Python package when you need the
+import surface as well:
 
 ```shell
 pip install skilly
@@ -124,11 +142,44 @@ Management commands accept the same destination options:
 
 Without destination options, `skilly` uses `.agents/skills`.
 
+Set `SKILLY_DIRECTORY` to change that default without passing `--directory`
+every time:
+
+```shell
+export SKILLY_DIRECTORY="$HOME/.config/skilly/skills"
+skilly list
+```
+
+`--directory`, `--local`, `--global`, `--claude`, `--codex`, and `--copilot`
+override `SKILLY_DIRECTORY` when provided explicitly.
+
 ```shell
 uvx skilly download https://github.com/example/project --global --codex
 uvx skilly list --local --claude
 ```
 
+#### Destination Mapping
+
+`skilly` resolves destination paths before use. Relative paths become absolute
+from the current working directory, and `--directory "~/.copilot"` expands `~`
+to your home directory.
+
+| Flags                | Resolved destination                                                      |
+|----------------------|---------------------------------------------------------------------------|
+| _none_               | `SKILLY_DIRECTORY` when set, otherwise `.agents/skills`                   |
+| `--local`            | `.agents/skills`                                                          |
+| `--global`           | `~/.agents/skills`                                                        |
+| `--claude`           | `.claude/skills`                                                          |
+| `--claude --global`  | `~/.claude/skills`                                                        |
+| `--codex`            | `.codex/skills`                                                           |
+| `--codex --global`   | `~/.codex/skills`                                                         |
+| `--copilot`          | `.github/skills`                                                          |
+| `--copilot --global` | `~/.copilot/skills`                                                       |
+| `--directory <path>` | Exactly that directory, after `~` expansion and absolute-path resolution. |
+
+`--directory` overrides `--local`, `--global`, `--claude`, `--codex`, and
+`--copilot`.
+
 ### GitHub Authentication
 
 Authenticated requests have higher GitHub API rate limits. Use the first

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xelandernt/skilly",
-  "version": "0.0.25",
+  "version": "0.0.26",
   "description": "Native npm launcher for the skilly CLI.",
   "license": "MIT",
   "bin": {