@xelandernt/skilly 0.0.25 → 0.0.28

package/README.md

@@ -1,3 +1,10 @@
+[![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)
+[![License](https://img.shields.io/github/license/xelandernt/skilly
+)](https://github.com/xelandernt/skilly/blob/main/LICENSE)
 # skilly
 
 Manage [Agent Skills](https://agentskills.io/specification) from the command line
@@ -8,14 +15,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
@@ -90,10 +109,10 @@ skills shipped by direct, development, and optional dependencies:
 uvx skilly scan
 ```
 
-Exclude dependency categories when needed:
+Filter named groups and extras when needed:
 
 ```shell
-uvx skilly scan --no-dependency-groups --no-optional-dependencies
+uvx skilly scan --group dev --exclude-extra docs
 ```
 
 ### Install GitHub Skills
@@ -124,11 +143,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
@@ -153,7 +205,10 @@ from skilly import ProjectSettings, Skill, SkillRepository
 
 repository = SkillRepository(
     directory=Path(".agents/skills"),
-    project=ProjectSettings(include_dependency_groups=True),
+    project=ProjectSettings(
+        dependency_groups=("dev",),
+        optional_dependencies=("docs",),
+    ),
 )
 
 created = repository.install(

package/package.json

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