@xelandernt/skilly 0.0.29 → 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
 
@@ -25,6 +25,7 @@ Manage [Agent Skills](https://agentskills.io/specification) from the command lin
   - [Install Dependency Skills](#install-dependency-skills)
   - [Install GitHub Skills](#install-github-skills)
   - [Destinations](#destinations)
+  - [Configure Destinations](#configure-destinations)
   - [GitHub Authentication](#github-authentication)
 - [Python API](#python-api)
 - [Development](#development)
@@ -35,8 +36,7 @@ Manage [Agent Skills](https://agentskills.io/specification) from the command lin
 
 ### Python
 ```shell
-uvx skilly --help           # run on-the-fly
-pip install skilly          # or install persistently
+uvx skilly --help
 ```
 
 ### Node
@@ -62,23 +62,21 @@ 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 |
 | `remove <name>` | Remove an installed skill by directory name |
 | `skillsmp search <query>` | Search SkillsMP and install a selected result |
 | `create` | Create a valid skill through a terminal wizard or explicit options |
+| `configure` | Set which directories skilly manages via TUI or CLI flags |
 
 Run `skilly <command> --help` for all options.
 
@@ -101,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
@@ -141,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`                                      |
@@ -155,10 +160,48 @@ 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_DEFAULT_DIRECTORY`.
+
+### Configure Destinations
+
+`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
+uvx skilly configure --show          # Print current config as TOML
+uvx skilly configure --reset         # Restore defaults
+```
+
+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
+uvx skilly configure --add-local .project/skills
+uvx skilly configure --remove-global /opt/skills
+uvx skilly configure --remove-local .project/skills
 ```
 
-`--directory` overrides all other destination options and `SKILLY_DIRECTORY`.
+Configuration is stored in `~/.skilly.toml`:
+
+```toml
+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
 
@@ -201,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.29",
+	"version": "0.0.31",
 	"description": "Native npm launcher for the skilly CLI.",
 	"license": "MIT",
 	"bin": {