@xelandernt/skilly 0.0.30 → 0.0.31

package/README.md

@@ -10,7 +10,7 @@
 
 Manage [Agent Skills](https://agentskills.io/specification) from the command line or Python.
 
-`skilly` creates specification-compliant skills, installs skills from GitHub or Python dependencies, and keeps managed skills up to date.
+`skilly` creates specification-compliant skills, installs skills from GitHub, Python, or Node dependencies, and keeps managed skills up to date.
 
 ## Table of Contents
 
@@ -62,17 +62,14 @@ brew install xelandernt/skilly/skilly
 ## Quick Start
 
 ```shell
-uvx skilly scan                       # Find skills from Python dependencies
-uvx skilly download <github-url>      # Install skills from GitHub
-uvx skilly list                       # Browse installed skills
-uvx skilly update                     # Preview available updates
+uvx skilly --help
 ```
 
 ## CLI Commands
 
 | Command | Purpose |
 |---------|---------|
-| `scan` | Find skills provided by the project's Python dependencies |
+| `scan` | Find skills provided by Python and Node project dependencies |
 | `download <github-url>` | Install one or more skills from GitHub |
 | `list` | Browse, update, or remove installed skills |
 | `update` | Preview available updates; `--yes` applies all |
@@ -102,18 +99,25 @@ Existing skills are rejected unless `--overwrite` is passed.
 
 ### Install Dependency Skills
 
-`skilly scan` reads `pyproject.toml` and the project's `.venv`, then surfaces skills shipped by dependencies:
+`skilly scan` discovers skills shipped by your project's dependencies across two ecosystems:
+
+- **Python** — reads `pyproject.toml` and scans the project's `.venv` for packages that bundle skills in a `skills/` directory.
+- **Node** — reads `package.json` (`dependencies`, `devDependencies`, `optionalDependencies`) and scans `node_modules/` for packages that bundle skills in a `skills/` directory.
 
 ```shell
 uvx skilly scan
 ```
 
-Include or exclude specific extras and dependency groups (flags are repeatable):
+Both ecosystems are scanned by default whenever the corresponding manifest and package directory exist. Results are shown with their source (e.g. `node:dependencies`, `python:project`) and status (`installable`, `installed`, `updatable`).
+
+Include or exclude specific Python extras and dependency groups:
 
 ```shell
 uvx skilly scan --group dev --group test --exclude-extra docs
+uvx skilly scan --no-project-dependencies         # skip [project].dependencies
 ```
 
+
 ### Install GitHub Skills
 
 ```shell
@@ -142,7 +146,7 @@ uvx skilly list --directory ~/custom     # Explicit directory
 
 | Flags                | Resolved destination                                  |
 |----------------------|-------------------------------------------------------|
-| _none_               | `SKILLY_DIRECTORY` if set, otherwise `.agents/skills` |
+| _none_               | `SKILLY_DEFAULT_DIRECTORY` if set, otherwise `.agents/skills` |
 | `--local`            | `.agents/skills`                                      |
 | `--global`           | `~/.agents/skills`                                    |
 | `--claude`           | `.claude/skills`                                      |
@@ -156,14 +160,14 @@ uvx skilly list --directory ~/custom     # Explicit directory
 Set a default destination:
 
 ```shell
-export SKILLY_DIRECTORY="$HOME/.config/skilly/skills"
+export SKILLY_DEFAULT_DIRECTORY="$HOME/.config/skilly/skills"
 ```
 
-`--directory` overrides all other destination options and `SKILLY_DIRECTORY`.
+`--directory` overrides all other destination options and `SKILLY_DEFAULT_DIRECTORY`.
 
 ### Configure Destinations
 
-`skilly configure` lets you choose which directories skilly should manage. Interactive terminals open a two-tab TUI (Global / Local). Non-interactive runs accept flags.
+`skilly configure` lets you choose which directories skilly should manage and which one opens by default. Interactive terminals open a two-tab TUI (Global / Local) showing all known agent directories as toggleable checkboxes (agents, claude, codex, copilot). Non-interactive runs accept flags.
 
 ```shell
 uvx skilly configure                 # Open the TUI
@@ -171,7 +175,12 @@ uvx skilly configure --show          # Print current config as TOML
 uvx skilly configure --reset         # Restore defaults
 ```
 
-Add or remove custom directories:
+In the TUI:
+- **Space** toggles a known directory on or off, or removes a custom one.
+- **Enter** sets the highlighted directory as the default (marked with a ★).
+- **Ctrl+S** saves; you must have a default directory selected before saving.
+
+Add or remove custom directories via CLI:
 
 ```shell
 uvx skilly configure --add-global /opt/skills
@@ -180,20 +189,20 @@ uvx skilly configure --remove-global /opt/skills
 uvx skilly configure --remove-local .project/skills
 ```
 
-Enable or disable built-in destinations (valid keys: `agents_global`, `agents_local`, `claude_global`, `claude_local`, `codex_global`, `codex_local`, `copilot_global`, `copilot_local`):
-
-```shell
-uvx skilly configure --enable agents_global --disable copilot_global
-```
-
 Configuration is stored in `~/.skilly.toml`:
 
 ```toml
-enabled_builtin = ["agents_global", "agents_local", ...]
-custom_global_dirs = []
-custom_local_dirs = []
+default_directory = ".agents/skills"
+
+[global]
+directories = ["~/.agents/skills", "/opt/skills"]
+
+[local]
+directories = [".agents/skills", ".project/skills"]
 ```
 
+The default directory opens first in interactive menus (`list`, `scan`, etc.).
+
 ### GitHub Authentication
 
 Set a token for higher API rate limits (first available wins: `SKILLY_GITHUB_TOKEN`, `GITHUB_TOKEN`, `GH_TOKEN`):
@@ -235,12 +244,35 @@ for match in repository.scan_project():
 Stateless discovery functions for one-shot reads:
 
 ```python
-from skilly import discover_installed_skills, discover_venv_skills
+from skilly import (
+    discover_installed_skills,
+    discover_node_modules_skills,
+    discover_venv_skills,
+)
 
 installed = discover_installed_skills()
-dependency_skills = discover_venv_skills()
+python_skills = discover_venv_skills()
+node_skills = discover_node_modules_skills()
+```
+
+`ProjectSettings` accepts a `NodeProjectSettings` to control node scanning:
+
+```python
+from skilly import NodeProjectSettings, ProjectSettings, SkillRepository
+
+repository = SkillRepository(
+    directory=Path(".agents/skills"),
+    project=ProjectSettings(
+        node=NodeProjectSettings(
+            include_dependencies=True,
+            include_dev_dependencies=False,
+        ),
+    ),
+)
 ```
 
+Set `node=None` to skip node ecosystem scanning entirely.
+
 SkillsMP client with typed results:
 
 ```python

package/package.json

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